Documentation for Indonesian Administrative Regions APIs

This documentation provides information on how to use the APIs for retrieving data about provinces, cities, districts, and villages in Indonesia.

Base URL

The base URL for accessing the APIs is http://localhost:3000.

/provinsi

GET /provinsi

Description

This endpoint retrieves a list of provinces in Indonesia.

Request

• Method: GET
• URL: /provinsi

Response

• Status Code: 200 OK
• Body: [ { "kode_provinsi": "01", "nama_provinsi": "Aceh" }, { "kode_provinsi": "02", "nama_provinsi": "Sumatera Utara" }, ...

]

/kota/:kode_provinsi

GET /kota/:kode_provinsi

Description

This endpoint retrieves a list of cities in Indonesia based on the province code.

Request

• Method: GET
• URL: /kota/:kode_provinsi
• Parameters:
• kode_provinsi: The code of the province for which cities are to be retrieved.

Response

• Status Code: 200 OK
• Body: [ { "kode_kota": "01", "kode_provinsi": "01", "nama_kota": "Banda Aceh" }, { "kode_kota": "02", "kode_provinsi": "01", "nama_kota": "Sabang" }, ... ]

/kecamatan/:kode_kota

GET /kecamatan/:kode_kota

Description

This endpoint retrieves a list of districts (kecamatan) in Indonesia based on the city code.

Request

• Method: GET
• URL: /kecamatan/:kode_kota
• Parameters:
• kode_kota: The code of the city for which districts are to be retrieved.

Response

• Status Code: 200 OK
• Body: [ { "kode_kecamatan": "01", "kode_kota": "01", "nama_kecamatan": "Kuta Alam" }, { "kode_kecamatan": "02", "kode_kota": "01", "nama_kecamatan": "Syiah Kuala" }, ... ]

/desa/:kode_kecamatan

GET /desa/:kode_kecamatan

Description

This endpoint retrieves a list of villages (desa) in Indonesia based on the district code.

Request

• Method: GET
• URL: /desa/:kode_kecamatan
• Parameters:
• kode_kecamatan: The code of the district for which villages are to be retrieved.

Response

• Status Code: 200 OK
• Body: [ { "kode_desa": "01", "kode_kecamatan": "01", "nama_desa": "Lamteuba" }, { "kode_desa": "02", "kode_kecamatan": "01", "nama_desa": "Meuraxa" }, ... ]

Example Usage

Retrieve List of Provinces

GET http://localhost:3000/provinsi

Retrieve List of Cities in a Province

GET http://localhost:3000/kota/01

Replace 01 with the province code for which you want to retrieve data.

Retrieve List of Districts in a City

GET http://localhost:3000/kecamatan/01

Replace 01 with the city code for which you want to retrieve data.

Retrieve List of Villages in a District

GET http://localhost:3000/desa/01

Replace 01 with the district code for which you want to retrieve data.

Note: Pastikan untuk mengganti http://localhost:3000 dengan URL sesuai dengan tempat Anda menjalankan server API.