Search Province
https://rajaongkir.komerce.id/api/v1/destination/province
The Search Province Endpoint serves as the foundational step in the hierarchical location selection process for RajaOngkir API. This endpoint provides a complete list of all provinces in Indonesia, which is essential for applications that need to implement structured location selection through cascading dropdown menus or multi-step forms.
This endpoint is particularly valuable for e-commerce platforms, logistics applications, and shipping calculators that require users to select their location in a guided, step-by-step manner. By starting with province selection, applications can provide a familiar and intuitive user experience similar to traditional address forms.
Endpoint Details
-
Method:
GET -
Base URL:
https://rajaongkir.komerce.id/api/v1/destination/province -
Description:
Retrieves a comprehensive list of all Indonesian provinces with their corresponding unique identifiers. This data serves as the first level in the location hierarchy and is required to subsequently fetch cities and districts within each province.
This endpoint is the starting point for the Step-by-Step Method integration approach in RajaOngkir API V2.
Request Body
curl --location 'https://rajaongkir.komerce.id/api/v1/destination/province' \
--header 'Key: YOUR_API_KEY'
Response
{
"meta": {
"message": "Success Get Province",
"code": 200,
"status": "success"
},
"data": [
{
"id": 1,
"name": "NUSA TENGGARA BARAT (NTB)"
},
{
"id": 2,
"name": "NUSA TENGGARA BARAT"
},
{
"id": 3,
"name": "MALUKU"
},
{
"id": 4,
"name": "KALIMANTAN SELATAN"
},
{
"id": 5,
"name": "KALIMANTAN TENGAH"
},
{
"id": 6,
"name": "JAWA BARAT"
},
{
"id": 7,
"name": "BENGKULU"
},
{
"id": 8,
"name": "KALIMANTAN TIMUR"
},
{
"id": 9,
"name": "KEPULAUAN RIAU"
},
{
"id": 10,
"name": "NANGGROE ACEH DARUSSALAM (NAD)"
},
{
"id": 11,
"name": "DKI JAKARTA"
},
{
"id": 12,
"name": "BANTEN"
},
{
"id": 13,
"name": "JAWA TENGAH"
},
{
"id": 14,
"name": "JAMBI"
},
{
"id": 15,
"name": "PAPUA"
},
{
"id": 16,
"name": "BALI"
},
{
"id": 17,
"name": "SUMATERA UTARA"
},
{
"id": 18,
"name": "GORONTALO"
},
{
"id": 19,
"name": "JAWA TIMUR"
},
{
"id": 20,
"name": "DI YOGYAKARTA"
},
{
"id": 21,
"name": "SULAWESI TENGGARA"
},
{
"id": 22,
"name": "NUSA TENGGARA TIMUR (NTT)"
},
{
"id": 23,
"name": "SULAWESI UTARA"
},
{
"id": 24,
"name": "SUMATERA BARAT"
},
{
"id": 25,
"name": "BANGKA BELITUNG"
},
{
"id": 26,
"name": "RIAU"
},
{
"id": 27,
"name": "SUMATERA SELATAN"
},
{
"id": 28,
"name": "SULAWESI TENGAH"
},
{
"id": 29,
"name": "KALIMANTAN BARAT"
},
{
"id": 30,
"name": "PAPUA BARAT"
},
{
"id": 31,
"name": "LAMPUNG"
},
{
"id": 32,
"name": "KALIMANTAN UTARA"
},
{
"id": 33,
"name": "MALUKU UTARA"
},
{
"id": 34,
"name": "SULAWESI SELATAN"
},
{
"id": 35,
"name": "SULAWESI BARAT"
}
]
}