Cek Ongkir V2

Tarif banyak kurir sekaligus berbasis kode kecamatan.

Halaman produkOpenAPI spec

Base URL

https://use.api.co.id

Panggil GET /courier/v2/rates dengan kode kecamatan asal & tujuan dan berat paket (kg), plus header x-api-co-id. Opsional: nilai barang, asuransi, dan dimensi paket. Response berisi daftar kurir + layanan lengkap dengan harga, estimasi, penanda termurah/tercepat, dan quote_id.

Kode kecamatan

Ambil kode kecamatan dari endpoint lokasi, berurutan:

1. GET /courier/v1/locations/provinces
2. GET /courier/v1/locations/cities?province=
3. GET /courier/v1/locations/districts?city=

Harga

• Rp 5 per panggilan sukses GET /courier/v2/rates (pay-as-you-go, dipotong dari saldo).
• Panggilan gagal tidak ditagih; saldo kurang mengembalikan 402.
• Endpoint lokasi & daftar kurir gratis.

Pemesanan (pickup)

Membuat pesanan (pickup) segera hadir. Endpoint pemesanan sedang disiapkan pada rilis berikutnya. quote_id dari cek ongkir ini adalah langkah pertama alur tersebut.

Pengganti versi lama

Versi ini menggantikan Cek Ongkir V1 yang berbasis kode desa (village code). V2 memakai kode kecamatan dan mengembalikan quote_id.

Cek Ongkir

Cek Ongkir (v2)

GET/courier/v2/rates

Hitung tarif pengiriman dari kecamatan asal ke kecamatan tujuan untuk semua kurir yang tersedia. Mengembalikan quote_id (untuk langkah pemesanan berikutnya) dan daftar rates.

Harga: Rp 5 per panggilan sukses (dipotong dari saldo, hanya jika tarif berhasil dikembalikan).

### Query Parameters - origin_district_code (required): kode kecamatan asal - destination_district_code (required): kode kecamatan tujuan - weight (required): berat paket dalam kilogram (> 0) - item_value (optional): nilai barang (IDR), untuk perhitungan asuransi - insurance (optional): sertakan biaya asuransi per kurir - length / width / height (optional): dimensi paket (cm)

Query parameter

Nama	Tipe	Keterangan
origin_district_codeWajib	string	Kode kecamatan asal (ambil dari /courier/v1/locations/districts) Contoh: 317405
destination_district_codeWajib	string	Kode kecamatan tujuan Contoh: 317305
weightWajib	number	Berat paket dalam kilogram (> 0) Contoh: 1
item_valueOpsional	integer	Nilai barang (IDR), dipakai untuk perhitungan asuransi Contoh: 100000
insuranceOpsional	boolean	Sertakan biaya asuransi per kurir Contoh: false
lengthOpsional	integer	Panjang paket (cm)
widthOpsional	integer	Lebar paket (cm)
heightOpsional	integer	Tinggi paket (cm)

Field response

Nama	Tipe	Keterangan
is_successOpsional	boolean	Contoh: true
messageOpsional	string	Contoh: Success
dataOpsional	object
data.quote_idOpsional	string
data.ratesOpsional	object[]
data.rates[].courier_codeOpsional	string
data.rates[].courier_nameOpsional	string
data.rates[].courier_imageOpsional	string
data.rates[].service_codeOpsional	string
data.rates[].service_nameOpsional	string
data.rates[].service_typeOpsional	string
data.rates[].etdOpsional	string
data.rates[].estOpsional	integer
data.rates[].is_codOpsional	boolean
data.rates[].normal_priceOpsional	integer
data.rates[].is_cheapestOpsional	boolean
data.rates[].is_fastestOpsional	boolean
data.rates[].priceOpsional	integer
data.rates[].handling_feeOpsional	integer
data.rates[].insurance_feeOpsional	integer
data.rates[].total_priceOpsional	integer

Request

curl -X GET "https://use.api.co.id/courier/v2/rates?origin_district_code=317405&destination_district_code=317305&weight=1" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": {    "quote_id": "q_8f3c1a9e2b7d4c05",    "rates": [      {        "courier_code": "jne",        "courier_name": "JNE Express",        "courier_image": "https://use.api.co.id/couriers/jne.png",        "service_code": "REG",        "service_name": "Reguler",        "service_type": "Standard",        "etd": "1-3",        "est": 3,        "is_cod": false,        "normal_price": 12000,        "is_cheapest": false,        "is_fastest": false,        "price": 10000,        "handling_fee": 500,        "insurance_fee": 0,        "total_price": 10500      },      {        "courier_code": "ninja",        "courier_name": "Ninja Express",        "courier_image": null,        "service_code": "NSTD",        "service_name": "Standard",        "service_type": "Regular",        "etd": "1-4",        "est": 4,        "is_cod": false,        "normal_price": 5000,        "is_cheapest": true,        "is_fastest": false,        "price": 4900,        "handling_fee": 0,        "insurance_fee": 0,        "total_price": 4900      }    ]  }}

Lokasi

Daftar Provinsi

GET/courier/v1/locations/provinces

Daftar provinsi (gratis). Dipakai untuk menelusuri kode kecamatan.

Request

curl -X GET "https://use.api.co.id/courier/v1/locations/provinces" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "31",      "name": "DKI Jakarta"    }  ]}

Daftar Kota/Kabupaten

GET/courier/v1/locations/cities

Daftar kota/kabupaten dalam sebuah provinsi (gratis).

Query parameter

Nama	Tipe	Keterangan
provinceWajib	string	Kode provinsi Contoh: 31

Request

curl -X GET "https://use.api.co.id/courier/v1/locations/cities?province=31" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "3174",      "name": "Jakarta Selatan"    }  ]}

Daftar Kecamatan

GET/courier/v1/locations/districts

Daftar kecamatan dalam sebuah kota/kabupaten (gratis). code di sini yang dipakai sebagai origin_district_code / destination_district_code.

Query parameter

Nama	Tipe	Keterangan
cityWajib	string	Kode kota/kabupaten Contoh: 3174

Request

curl -X GET "https://use.api.co.id/courier/v1/locations/districts?city=3174" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "317405",      "name": "Kebayoran Lama"    }  ]}

Kurir

Daftar Kurir

GET/courier/v1/couriers

Daftar kurir yang tersedia (gratis).

Request

curl -X GET "https://use.api.co.id/courier/v1/couriers" \  -H "x-api-co-id: $API_CO_ID_KEY"

Response

200OKSuccessful response

{  "is_success": true,  "message": "Success",  "data": [    {      "code": "jne",      "name": "JNE Express",      "logo": "https://use.api.co.id/couriers/jne.png",      "cod": true    },    {      "code": "ninja",      "name": "Ninja Express",      "logo": null,      "cod": false    }  ]}