Indonesia Regional

Provinces, cities/regencies, and districts.

Product pagePostman collectionOpenAPI spec

Base URL

https://use.api.co.id

All endpoints live under the /regional/indonesia path and are called with the x-api-co-id header. Filters (name, parent region code) and the page number are sent as query parameters. The response contains structured regional metadata and identifiers.

Data structure

Level	Endpoint
Province (Provinsi)	/provinces
Regency (Kabupaten/Kota)	/regencies
District (Kecamatan)	/districts
Village (Kelurahan/Desa)	/villages
Postal code (linked to villages)	/postal-codes

Data can be navigated hierarchically (province → regency → district → village), filtered by name, and paginated.

Premium endpoints

The following endpoints require a premium subscription:

Endpoint	Purpose
/regional/indonesia/search	Advanced search across all region levels by name or postal code
/regional/indonesia/postal-codes	List all postal codes
/regional/indonesia/postal-codes/:postal_code	Get villages by postal code

The is_courier_support field

Every village record includes an is_courier_support field. It tells you whether the area is supported for shipping cost checks:

• true — you can use this region code directly with the Shipping Cost API.
• false — this area is not yet supported for shipping cost checks. Please open a ticket to request activation for the area before checking shipping costs.

Checking is_courier_support first lets you confirm a region code is supported, so shipping cost calculations don't fail.

Provinces

List All Provinces

GET/regional/indonesia/provinces

Get all provinces in Indonesia.

### Query Parameters - name (optional): Filter by province name (case-insensitive partial match) - page (optional): Page number (default: 1) - Note: Pagination size is fixed at 100 items per page and cannot be configured

### Examples ``bash # Get all provinces GET /regional/indonesia/provinces # Search provinces by name GET /regional/indonesia/provinces?name=jawa # With pagination GET /regional/indonesia/provinces?page=1

Query parameters

Name	Type	Description
nameOptional	string	Filter by province name (case-insensitive partial match) Example: jawa
pageOptional	integer	Page number Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/provinces" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "11",      "name": "ACEH"    },    {      "code": "12",      "name": "SUMATERA UTARA"    },    {      "code": "13",      "name": "SUMATERA BARAT"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 34,    "total_page": 1  }}

Get Province by Code

GET/regional/indonesia/provinces/{code}

Get a specific province by code, including all regencies in that province.

### Path Parameters - code (required): Province code (2 digits)

### Examples ``bash # Get Aceh province (code 11) GET /regional/indonesia/provinces/11 # Get Jakarta province (code 31) GET /regional/indonesia/provinces/31

Path parameters

Name	Type	Description
codeRequired	string	Province code (2 digits) Example: 11

Request

curl -X GET "https://use.api.co.id/regional/indonesia/provinces/11" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": {    "code": "11",    "name": "ACEH"  }}

Get Regencies in Province

GET/regional/indonesia/provinces/{code}/regencies

Get all regencies/cities in a specific province.

### Path Parameters - code (required): Province code

### Query Parameters - name (optional): Filter by regency name - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Path parameters

Name	Type	Description
codeRequired	string	Province code Example: 11

Query parameters

Name	Type	Description
nameOptional	string	Filter by regency name (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/provinces/11/regencies" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "1101",      "name": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    },    {      "code": "1102",      "name": "KABUPATEN ACEH SINGKIL",      "province_code": "11",      "province": "ACEH"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 23,    "total_page": 1  }}

Regencies

List All Regencies

GET/regional/indonesia/regencies

Get all regencies/cities in Indonesia.

### Query Parameters - province_code (optional): Filter by province code - name (optional): Filter by regency name - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Query parameters

Name	Type	Description
province_codeOptional	string	Filter by province code (optional)
nameOptional	string	Filter by regency name (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/regencies" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "1101",      "name": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    },    {      "code": "1102",      "name": "KABUPATEN ACEH SINGKIL",      "province_code": "11",      "province": "ACEH"    },    {      "code": "1201",      "name": "KABUPATEN TAPANULI TENGAH",      "province_code": "12",      "province": "SUMATERA UTARA"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 514,    "total_page": 6  }}

Get Regency by Code

GET/regional/indonesia/regencies/{code}

Get a specific regency by code.

### Path Parameters - code (required): Regency code (4 digits)

Path parameters

Name	Type	Description
codeRequired	string	Regency code (4 digits) Example: 1101

Request

curl -X GET "https://use.api.co.id/regional/indonesia/regencies/1101" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": {    "code": "1101",    "name": "KABUPATEN SIMEULUE",    "province_code": "11",    "province": "ACEH"  }}

Get Districts in Regency

GET/regional/indonesia/regencies/{code}/districts

Get all districts in a specific regency.

### Path Parameters - code (required): Regency code

### Query Parameters - name (optional): Filter by district name - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Path parameters

Name	Type	Description
codeRequired	string	Regency code Example: 1101

Query parameters

Name	Type	Description
nameOptional	string	Filter by district name (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/regencies/1101/districts" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "110101",      "name": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    },    {      "code": "110102",      "name": "SIMEULUE TIMUR",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 10,    "total_page": 1  }}

Districts

List All Districts

GET/regional/indonesia/districts

Get all districts in Indonesia.

### Query Parameters - regency_code (optional): Filter by regency code - name (optional): Filter by district name - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Query parameters

Name	Type	Description
regency_codeOptional	string	Filter by regency code (optional)
nameOptional	string	Filter by district name (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/districts" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "110101",      "name": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    },    {      "code": "110102",      "name": "SIMEULUE TIMUR",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 7213,    "total_page": 73  }}

Get District by Code

GET/regional/indonesia/districts/{code}

Get a specific district by code.

### Path Parameters - code (required): District code (6 digits)

Path parameters

Name	Type	Description
codeRequired	string	District code (6 digits) Example: 110101

Request

curl -X GET "https://use.api.co.id/regional/indonesia/districts/110101" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": {    "code": "110101",    "name": "TEUPAH SELATAN",    "regency_code": "1101",    "regency": "KABUPATEN SIMEULUE",    "province_code": "11",    "province": "ACEH"  }}

Get Villages in District

GET/regional/indonesia/districts/{code}/villages

Get all villages in a specific district.

### Path Parameters - code (required): District code

### Query Parameters - name (optional): Filter by village name - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Path parameters

Name	Type	Description
codeRequired	string	District code Example: 110101

Query parameters

Name	Type	Description
nameOptional	string	Filter by village name (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/districts/110101/villages" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "1101010001",      "name": "LATIUNG",      "district_code": "110101",      "district": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH",      "postal_codes": [        "23891"      ],      "is_courier_support": true    },    {      "code": "1101010002",      "name": "LABUHAN BAJAU",      "district_code": "110101",      "district": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH",      "postal_codes": [        "23891"      ],      "is_courier_support": true    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 18,    "total_page": 1  }}

Villages

List All Villages

GET/regional/indonesia/villages

Get all villages in Indonesia.

### Query Parameters - district_code (optional): Filter by district code - name (optional): Filter by village name - postal_code (optional): Filter by postal code - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

Query parameters

Name	Type	Description
district_codeOptional	string	Filter by district code (optional)
nameOptional	string	Filter by village name (optional)
postal_codeOptional	string	Filter by postal code (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/villages" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "1101010001",      "name": "LATIUNG",      "district_code": "110101",      "district": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH",      "postal_codes": [        "23891"      ],      "is_courier_support": true    },    {      "code": "1101010002",      "name": "LABUHAN BAJAU",      "district_code": "110101",      "district": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH",      "postal_codes": [        "23891"      ],      "is_courier_support": true    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 83916,    "total_page": 840  }}

Get Village by Code

GET/regional/indonesia/villages/{code}

Get a specific village by code with full hierarchy information.

### Path Parameters - code (required): Village code (10 digits)

Path parameters

Name	Type	Description
codeRequired	string	Village code (10 digits) Example: 1101010001

Request

curl -X GET "https://use.api.co.id/regional/indonesia/villages/1101010001" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": {    "code": "1101010001",    "name": "LATIUNG",    "district_code": "110101",    "district": "TEUPAH SELATAN",    "regency_code": "1101",    "regency": "KABUPATEN SIMEULUE",    "province_code": "11",    "province": "ACEH",    "postal_codes": [      "23891"    ],    "is_courier_support": true  }}

Postal Codes (Premium)

List All Postal Codes

GET/regional/indonesia/postal-codes

Get all postal codes. This endpoint requires a premium subscription.

### Query Parameters - village_code (optional): Filter by village code - postal_code (optional): Filter by postal code - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

### Error Responses - 403 Forbidden: User is not a premium member - 401 Unauthorized: User not authenticated

Query parameters

Name	Type	Description
village_codeOptional	string	Filter by village code (optional)
postal_codeOptional	string	Filter by postal code (optional)
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/postal-codes" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "id": 1,      "postal_code": "23891",      "village_code": "1101010001",      "village": "LATIUNG",      "district_code": "110101",      "district": "TEUPAH SELATAN",      "regency_code": "1101",      "regency": "KABUPATEN SIMEULUE",      "province_code": "11",      "province": "ACEH"    },    {      "id": 2,      "postal_code": "12210",      "village_code": "3174050001",      "village": "GROGOL UTARA",      "district_code": "317405",      "district": "KEBAYORAN LAMA",      "regency_code": "3174",      "regency": "KOTA JAKARTA SELATAN",      "province_code": "31",      "province": "DKI JAKARTA"    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 87657,    "total_page": 877  }}

Get Villages by Postal Code

GET/regional/indonesia/postal-codes/{postal_code}

Find villages by postal code. This endpoint requires a premium subscription.

### Path Parameters - postal_code (required): Postal code (5 digits)

### Examples ``bash # Find villages with postal code 12345 GET /regional/indonesia/postal-codes/12345

### Error Responses - 403 Forbidden: User is not a premium member - 401 Unauthorized: User not authenticated

Path parameters

Name	Type	Description
postal_codeRequired	string	Postal code (5 digits) Example: 12210

Request

curl -X GET "https://use.api.co.id/regional/indonesia/postal-codes/12210" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "3174050001",      "name": "GROGOL UTARA",      "district_code": "317405",      "district": "KEBAYORAN LAMA",      "regency_code": "3174",      "regency": "KOTA JAKARTA SELATAN",      "province_code": "31",      "province": "DKI JAKARTA",      "postal_codes": [        "12210"      ],      "is_courier_support": true    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 1,    "total_page": 1  }}

Search (Premium)

Search Regional Data

GET/regional/indonesia/search

Search across all regional data types by name or postal code. This endpoint requires a premium subscription.

### Query Parameters - query (required): Search term (can be a name or postal code) - type (optional): Filter by type (province, regency, district, village) - page (optional): Page number - Note: Pagination size is fixed at 100 items per page and cannot be configured

### Examples ``bash # Search by name GET /regional/indonesia/search?query=jakarta # Search by postal code GET /regional/indonesia/search?query=12210 # Search only villages GET /regional/indonesia/search?query=bantul&type=village

### Error Responses - 403 Forbidden: User is not a premium member - 401 Unauthorized: User not authenticated

Query parameters

Name	Type	Description
queryRequired	string	Search term (required) - can be a name (province, regency, district, village) or postal code Example: jakarta
typeOptional	string	Filter by type: province, regency, district, village (optional) Values: provinceregencydistrictvillage
pageOptional	integer	Page number (optional) Example: 1

Request

curl -X GET "https://use.api.co.id/regional/indonesia/search?query=jakarta" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "status": "success",  "timestamp": "2025-12-25 08:55:38",  "result": [    {      "province_code": "31",      "province": "DKI JAKARTA",      "city_code": "3174",      "city": "KOTA JAKARTA SELATAN",      "district_code": "317405",      "district": "KEBAYORAN LAMA",      "village_code": "3174050001",      "village": "GROGOL UTARA",      "postal_code": "12210",      "is_courier_support": true    }  ],  "paging": {    "page": 1,    "size": 100,    "total_item": 1,    "total_page": 1  }}