RajaOngkir: Rajanya Ongkos Kirim Terpadu

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"
    }
  ]
}

More Information

Need Help?

For questions about integration or the API, hit the live chat. Our team's on standby.

Search Province

Endpoint Details

Request Body

Response

More Information

Need Help?

On this page