{"info":{"_postman_id":"d6409adc-f55f-4341-adf9-1943d33a5722","name":"Indonesia Regional API v2","description":"

Complete API collection for Indonesian regional data including provinces, regencies, districts, villages, and postal codes.

Features

Access to all Indonesian provinces, regencies, districts, and villages
Hierarchical navigation (province → regency → district → village)
Search across all regional types by name or postal code
Postal code queries
Name-based filtering
Pagination support
Premium endpoints for advanced search and postal code access

Authentication

All requests require an API key in the x-api-co-id header.

Premium Endpoints

The following endpoints require a premium subscription:

/regional/indonesia/search - Advanced search by name or postal code
/regional/indonesia/postal-codes - List all postal codes
/regional/indonesia/postal-codes/:postal_code - Get villages by postal code

Base URL

https://use.api.co.id/regional/indonesia\n

Data Structure

Province (Provinsi) - 34 provinces
Regency (Kabupaten/Kota) - Cities and regencies
District (Kecamatan) - Subdistricts
Village (Kelurahan/Desa) - Villages and urban wards
Postal Code (Kode Pos) - Postal codes linked to villages

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"d6409adc-f55f-4341-adf9-1943d33a5722","publishedId":"2sBXVZouWf","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-25T02:31:47.000Z"},"item":[{"name":"Provinces","item":[{"name":"List All Provinces","id":"aeb1d1cd-fbbb-4bd5-856f-18d05471a613","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces","description":"

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

# Get all provinces\nGET /regional/indonesia/provinces\n\n# Search provinces by name\nGET /regional/indonesia/provinces?name=jawa\n\n# With pagination\nGET /regional/indonesia/provinces?page=1\n

\n","urlObject":{"path":["regional","indonesia","provinces"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"3aad33f7-759f-4927-a4ff-5b5f51c2ae2c","name":"Success - All Provinces","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"11\",\n \"name\": \"ACEH\"\n },\n {\n \"code\": \"12\",\n \"name\": \"SUMATERA UTARA\"\n },\n {\n \"code\": \"13\",\n \"name\": \"SUMATERA BARAT\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 34,\n \"total_page\": 12\n }\n}"}],"_postman_id":"aeb1d1cd-fbbb-4bd5-856f-18d05471a613"},{"name":"Get Province by Code","id":"5e832cf1-1fd2-465d-8802-0f556d5b9178","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces/:code","description":"

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

Path Parameters

code (required): Province code (2 digits)

Examples

# Get Aceh province (code 11)\nGET /regional/indonesia/provinces/11\n\n# Get Jakarta province (code 31)\nGET /regional/indonesia/provinces/31\n

\n","urlObject":{"path":["regional","indonesia","provinces",":code"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"52e17281-89ad-44fa-a3d5-9d6073107ad5","description":{"content":"

Province code (2 digits, e.g., 11 for Aceh)

\n","type":"text/plain"},"type":"any","value":"11","key":"code"}]}},"response":[{"id":"a97b0c8c-851c-4088-857a-477554ecdf1c","name":"Success - Province with Regencies","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces/11"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"code\": \"11\",\n \"name\": \"ACEH\"\n }\n}"}],"_postman_id":"5e832cf1-1fd2-465d-8802-0f556d5b9178"},{"name":"Get Regencies in Province","id":"1f204b0f-055d-4b8f-84f6-f35a9d4b6d01","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces/:code/regencies","description":"

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

\n","urlObject":{"path":["regional","indonesia","provinces",":code","regencies"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by regency name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[{"id":"d82cd8e9-68c0-4952-b753-0a7686c38041","description":{"content":"

Province code

\n","type":"text/plain"},"type":"any","value":"11","key":"code"}]}},"response":[{"id":"21222d00-d440-4bf7-a5de-a3068db40ec1","name":"Success - Regencies in Province","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/provinces/11/regencies"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"1101\",\n \"name\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"code\": \"1102\",\n \"name\": \"KABUPATEN ACEH SINGKIL\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 23,\n \"total_page\": 1\n }\n}"}],"_postman_id":"1f204b0f-055d-4b8f-84f6-f35a9d4b6d01"}],"id":"b694e29f-849d-4e10-b4f6-0acc71508fb6","description":"

Endpoints for accessing province data.

\n","_postman_id":"b694e29f-849d-4e10-b4f6-0acc71508fb6"},{"name":"Regencies","item":[{"name":"List All Regencies","id":"38da6239-32ba-4b79-b883-edcf467c907f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies","description":"

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

\n","urlObject":{"path":["regional","indonesia","regencies"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by province code (optional)

\n","type":"text/plain"},"key":"province_code","value":""},{"disabled":true,"description":{"content":"

Filter by regency name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"8e49a87c-9514-41d6-9a96-c57dc68902dc","name":"Success - All Regencies","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"1101\",\n \"name\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"code\": \"1102\",\n \"name\": \"KABUPATEN ACEH SINGKIL\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"code\": \"1201\",\n \"name\": \"KABUPATEN TAPANULI TENGAH\",\n \"province_code\": \"12\",\n \"province\": \"SUMATERA UTARA\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 514,\n \"total_page\": 6\n }\n}"}],"_postman_id":"38da6239-32ba-4b79-b883-edcf467c907f"},{"name":"Get Regency by Code","id":"d93a75b4-90c6-43cb-aedc-b02e3a7f4345","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies/:code","description":"

Get a specific regency by code.

Path Parameters

code (required): Regency code (4 digits)

\n","urlObject":{"path":["regional","indonesia","regencies",":code"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"0fdcafb2-fd1c-4d46-a695-25cd7d9155a9","description":{"content":"

Regency code (4 digits)

\n","type":"text/plain"},"type":"any","value":"1101","key":"code"}]}},"response":[{"id":"00e51694-ec76-4d37-b92e-0c0289c90f9f","name":"Success - Regency by Code","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies/1101"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"code\": \"1101\",\n \"name\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n }\n}"}],"_postman_id":"d93a75b4-90c6-43cb-aedc-b02e3a7f4345"},{"name":"Get Districts in Regency","id":"cf3019d7-7bc4-4440-8833-f1c0e1eb7492","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies/:code/districts","description":"

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

\n","urlObject":{"path":["regional","indonesia","regencies",":code","districts"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by district name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[{"id":"2805332b-7238-47b7-ab9b-4738044b5324","description":{"content":"

Regency code

\n","type":"text/plain"},"type":"any","value":"1101","key":"code"}]}},"response":[{"id":"82b5b70d-6573-4690-83ca-8a456eecea5e","name":"Success - Districts in Regency","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/regencies/1101/districts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"110101\",\n \"name\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"code\": \"110102\",\n \"name\": \"SIMEULUE TIMUR\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 10,\n \"total_page\": 1\n }\n}"}],"_postman_id":"cf3019d7-7bc4-4440-8833-f1c0e1eb7492"}],"id":"7561045c-edbc-4a0b-bc4c-d6d996304956","description":"

Endpoints for accessing regency/city data.

\n","_postman_id":"7561045c-edbc-4a0b-bc4c-d6d996304956"},{"name":"Districts","item":[{"name":"List All Districts","id":"fed99665-2e68-4ddb-ae0c-2dedd23f9b60","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts","description":"

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

\n","urlObject":{"path":["regional","indonesia","districts"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by regency code (optional)

\n","type":"text/plain"},"key":"regency_code","value":""},{"disabled":true,"description":{"content":"

Filter by district name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"7caebe7f-778e-49f7-abeb-1cecc51fa4f0","name":"Success - All Districts","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"110101\",\n \"name\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"code\": \"110102\",\n \"name\": \"SIMEULUE TIMUR\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 7213,\n \"total_page\": 73\n }\n}"}],"_postman_id":"fed99665-2e68-4ddb-ae0c-2dedd23f9b60"},{"name":"Get District by Code","id":"287a1439-4245-426e-91cb-d33f24dc14fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts/:code","description":"

Get a specific district by code.

Path Parameters

code (required): District code (6 digits)

\n","urlObject":{"path":["regional","indonesia","districts",":code"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"9542b55c-d147-4e96-8dcb-d07bceb40880","description":{"content":"

District code (6 digits)

\n","type":"text/plain"},"type":"any","value":"110101","key":"code"}]}},"response":[{"id":"05ff139c-a6aa-41a7-999d-907abe6c4d7d","name":"Success - District by Code","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts/110101"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"code\": \"110101\",\n \"name\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n }\n}"}],"_postman_id":"287a1439-4245-426e-91cb-d33f24dc14fb"},{"name":"Get Villages in District","id":"2b1a231f-abf7-464c-a838-aeeaabb5ef43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts/:code/villages","description":"

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

\n","urlObject":{"path":["regional","indonesia","districts",":code","villages"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by village name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[{"id":"fa252c2a-8511-443f-b72b-29cb5b607a86","description":{"content":"

District code

\n","type":"text/plain"},"type":"any","value":"110101","key":"code"}]}},"response":[{"id":"4507aad8-5c7f-42b8-9604-f78b1b67e08b","name":"Success - Villages in District","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/districts/110101/villages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"1101010001\",\n \"name\": \"LATIUNG\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\",\n \"postal_codes\": [\"23891\"]\n },\n {\n \"code\": \"1101010002\",\n \"name\": \"LABUHAN BAJAU\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\",\n \"postal_codes\": [\"23891\"]\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 18,\n \"total_page\": 1\n }\n}"}],"_postman_id":"2b1a231f-abf7-464c-a838-aeeaabb5ef43"}],"id":"680d27d6-a494-4984-be30-4852bac077a8","description":"

Endpoints for accessing district data.

\n","_postman_id":"680d27d6-a494-4984-be30-4852bac077a8"},{"name":"Villages","item":[{"name":"List All Villages","id":"5e8219c5-81f6-4bfe-912e-7c1effba7cd9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/villages","description":"

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

\n","urlObject":{"path":["regional","indonesia","villages"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by district code (optional)

\n","type":"text/plain"},"key":"district_code","value":""},{"disabled":true,"description":{"content":"

Filter by village name (optional)

\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"

Filter by postal code (optional)

\n","type":"text/plain"},"key":"postal_code","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"7ef9c92b-da29-45e4-ad30-958ab105aacd","name":"Success - All Villages","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/villages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"1101010001\",\n \"name\": \"LATIUNG\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\",\n \"postal_codes\": [\"23891\"]\n },\n {\n \"code\": \"1101010002\",\n \"name\": \"LABUHAN BAJAU\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\",\n \"postal_codes\": [\"23891\"]\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 83916,\n \"total_page\": 840\n }\n}"}],"_postman_id":"5e8219c5-81f6-4bfe-912e-7c1effba7cd9"},{"name":"Get Village by Code","id":"fedb353b-9f13-4922-87bf-51bda7487887","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/villages/:code","description":"

Get a specific village by code with full hierarchy information.

Path Parameters

code (required): Village code (10 digits)

\n","urlObject":{"path":["regional","indonesia","villages",":code"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"4ef8ae2b-f428-44c9-99ca-d8af72324f69","description":{"content":"

Village code (10 digits)

\n","type":"text/plain"},"type":"any","value":"1101010001","key":"code"}]}},"response":[{"id":"3b462932-dcbb-45f7-8028-dda5d77c6015","name":"Success - Village by Code","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/villages/1101010001"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"code\": \"1101010001\",\n \"name\": \"LATIUNG\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\",\n \"postal_codes\": [\"23891\"]\n }\n}"}],"_postman_id":"fedb353b-9f13-4922-87bf-51bda7487887"}],"id":"2ffa4831-2b1e-4fbb-8994-29893e396e51","description":"

Endpoints for accessing village data.

\n","_postman_id":"2ffa4831-2b1e-4fbb-8994-29893e396e51"},{"name":"Postal Codes (Premium)","item":[{"name":"List All Postal Codes","id":"217c993c-4ee0-4418-8928-263f988a064f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes","description":"

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

\n","urlObject":{"path":["regional","indonesia","postal-codes"],"host":["https://use.api.co.id"],"query":[{"disabled":true,"description":{"content":"

Filter by village code (optional)

\n","type":"text/plain"},"key":"village_code","value":""},{"disabled":true,"description":{"content":"

Filter by postal code (optional)

\n","type":"text/plain"},"key":"postal_code","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"5f7a0e51-a291-4229-a588-7b6c35b2db01","name":"Success - All Postal Codes","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"id\": 1,\n \"postal_code\": \"23891\",\n \"village_code\": \"1101010001\",\n \"village\": \"LATIUNG\",\n \"district_code\": \"110101\",\n \"district\": \"TEUPAH SELATAN\",\n \"regency_code\": \"1101\",\n \"regency\": \"KABUPATEN SIMEULUE\",\n \"province_code\": \"11\",\n \"province\": \"ACEH\"\n },\n {\n \"id\": 2,\n \"postal_code\": \"12210\",\n \"village_code\": \"3174050001\",\n \"village\": \"GROGOL UTARA\",\n \"district_code\": \"317405\",\n \"district\": \"KEBAYORAN LAMA\",\n \"regency_code\": \"3174\",\n \"regency\": \"KOTA JAKARTA SELATAN\",\n \"province_code\": \"31\",\n \"province\": \"DKI JAKARTA\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 87657,\n \"total_page\": 877\n }\n}"},{"id":"03a70aad-b502-43a1-b894-25e4a11f159c","name":"Error - Not Premium","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"This endpoint is for premium members only\"\n}"}],"_postman_id":"217c993c-4ee0-4418-8928-263f988a064f"},{"name":"Get Villages by Postal Code","id":"c2f767f5-69e1-4f24-bed5-2833b51aade2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes/:postal_code","description":"

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

Path Parameters

postal_code (required): Postal code (5 digits)

Examples

# Find villages with postal code 12345\nGET /regional/indonesia/postal-codes/12345\n

Error Responses

403 Forbidden: User is not a premium member
401 Unauthorized: User not authenticated

\n","urlObject":{"path":["regional","indonesia","postal-codes",":postal_code"],"host":["https://use.api.co.id"],"query":[],"variable":[{"id":"76a08851-7a4f-4743-9640-328790b227a0","description":{"content":"

Postal code (5 digits)

\n","type":"text/plain"},"type":"any","value":"12345","key":"postal_code"}]}},"response":[{"id":"4725c444-7a9d-4ab2-9190-cae11f485cdc","name":"Success - Villages by Postal Code","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes/12210"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": [\n {\n \"code\": \"3174050001\",\n \"name\": \"GROGOL UTARA\",\n \"district_code\": \"317405\",\n \"district\": \"KEBAYORAN LAMA\",\n \"regency_code\": \"3174\",\n \"regency\": \"KOTA JAKARTA SELATAN\",\n \"province_code\": \"31\",\n \"province\": \"DKI JAKARTA\",\n \"postal_codes\": [\"12210\"]\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 1,\n \"total_page\": 1\n }\n}"},{"id":"87c792a6-baf6-4f34-a082-9045442f803a","name":"Error - Not Premium","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/postal-codes/12210"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"This endpoint is for premium members only\"\n}"}],"_postman_id":"c2f767f5-69e1-4f24-bed5-2833b51aade2"}],"id":"a90d26b9-73e8-4e6c-a90d-625ca07f76d7","description":"

Endpoints for accessing postal code data. All postal code endpoints require premium subscription.

\n","_postman_id":"a90d26b9-73e8-4e6c-a90d-625ca07f76d7"},{"name":"Search (Premium)","item":[{"name":"Search Regional Data","id":"5705fd67-29be-405a-a63f-7f0b344852eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/search?query=jakarta","description":"

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

# Search by name\nGET /regional/indonesia/search?query=jakarta\n\n# Search by postal code\nGET /regional/indonesia/search?query=12210\n\n# Search only villages\nGET /regional/indonesia/search?query=bantul&type=village\n

Error Responses

403 Forbidden: User is not a premium member
401 Unauthorized: User not authenticated

\n","urlObject":{"path":["regional","indonesia","search"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Search term (required) - can be a name (province, regency, district, village) or postal code

\n","type":"text/plain"},"key":"query","value":"jakarta"},{"disabled":true,"description":{"content":"

Filter by type: province, regency, district, village (optional)

\n","type":"text/plain"},"key":"type","value":""},{"disabled":true,"description":{"content":"

Page number (optional)

\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"f3fb4c4d-7e2b-41e5-bf66-acbecc9ef810","name":"Success - Search Results","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/search?query=jakarta","host":["https://use.api.co.id"],"path":["regional","indonesia","search"],"query":[{"key":"query","value":"jakarta"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"timestamp\": \"2025-12-25 08:55:38\",\n \"result\": [\n {\n \"province_code\": \"31\",\n \"province\": \"DKI JAKARTA\",\n \"city_code\": \"3174\",\n \"city\": \"KOTA JAKARTA SELATAN\",\n \"district_code\": \"317405\",\n \"district\": \"KEBAYORAN LAMA\",\n \"village_code\": \"3174050001\",\n \"village\": \"GROGOL UTARA\",\n \"postal_code\": \"12210\"\n }\n ],\n \"paging\": {\n \"page\": 1,\n \"size\": 100,\n \"total_item\": 1,\n \"total_page\": 1\n }\n}"},{"id":"fe813733-f57a-4cd6-aef4-105c082df414","name":"Error - Not Premium","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/search"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"This endpoint is for premium members only\"\n}"}],"_postman_id":"5705fd67-29be-405a-a63f-7f0b344852eb"}],"id":"53d62d25-e290-4eb1-992a-9fd53012fb24","description":"

Endpoints for searching regional data. Search endpoint requires premium subscription.

\n","_postman_id":"53d62d25-e290-4eb1-992a-9fd53012fb24"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string","description":"Base URL for the API"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your API key for authentication. Get it from api.dashboard or your database."}]}