Wilayah Indonesia

Open API · v3 · no key required

Every administrative code in Indonesia, one request away.

Provinces, regencies and cities, districts, and villages as clean JSON with full parent chains. Try it below: every control on this page is a real API call.

Provinces
38
Regencies and cities
514
Districts
7,277
Villages
83,731
curl https://wilayah.rone.dev/api/code/3301012001

Explorer

Pick a region level by level, or jump straight to a code. Each request the page sends is logged next to the result.

Full codes use /api/code, slash or dot codes use the /api/s shorthand.

Nothing selected yet. Choose a province to start.

Requests

    
        
    
      
    
    
    
  
    
  

    


    
  
    
    
    Analytics
    
    
    Totals for Indonesia, from /api/stats/0. Select a row to drill down.
    
  
    

  
    
    
    Loading statistics…
    
  
    

    


    
  
    
    
    Reference
    
    
    
      Every endpoint is GET and returns the same envelope:
      success, data, error and meta
      (api_version, timestamp, request_id, duration_ms).
      Failures carry a stable error code.
    
    
  
    

  
    
    
    
      
        
    EndpointPurposeGroupExample
    
          
      
        
        
    
          /api/
          API Root
          root
          /api/
        
    
        
        
    
          /api/health
          Health Check
          root
          /api/health
        
    
        
        
    
          /api/code/{code}
          Look up a region by code
          lookup
          /api/code/3301012001
        
    
        
        
    
          /api/stats/{code}
          Region statistics
          stats
          /api/stats/33
        
    
        
        
    
          /api/s/{province_code}
          Shorthand: province
          shorthand
          /api/s/33
        
    
        
        
    
          /api/s/{province_code}/{regency_number}
          Shorthand: regency or city
          shorthand
          /api/s/33/1
        
    
        
        
    
          /api/s/{province_code}/{regency_number}/{district_number}
          Shorthand: district
          shorthand
          /api/s/33/1/1
        
    
        
        
    
          /api/s/{province_code}/{regency_number}/{district_number}/{village_number}
          Shorthand: village
          shorthand
          /api/s/33/1/1/2001
        
    
        
        
    
          /api/0
          List provinces
          hierarchy
          /api/0
        
    
        
        
    
          /api/{province_code}
          List regencies and cities
          hierarchy
          /api/33
        
    
        
        
    
          /api/{province_code}/{regency_code}
          List districts
          hierarchy
          /api/33/3301
        
    
        
        
    
          /api/{province_code}/{regency_code}/{district_code}
          List villages
          hierarchy
          /api/33/3301/330101
        
    
        
          
    
    
  
    

  
    
    
    
      
    Code format
    
      
    Full codes grow by level: 33 → 3301 → 330101 → 3301012001. short_code splits them as 33/01/01/2001.
    
    
    
    
    
      
    Parent chains
    
      
    Lookups return the full chain up to the province. Lists return only the direct parent, and only with ?parent=true.
    
    
    
    
    
      
    Kinds
    
      
    Regency segments 71–99 are cities (kota), the rest regencies (kabupaten). A village segment starting with 1 is an urban village (kelurahan), 2 a rural village (desa), 3 a customary village (desa adat).
    
    
    
    
    
      
    Bulk data
    
      
    Need everything? Take the JSON files from the repository instead of crawling the API.