Cek Ongkir

Cek Ongkir

Menghitung daftar tarif pengiriman dari semua kurir untuk satu rute. Setiap pemanggilan yang berhasil dikenai biaya Rp 5 dari saldo Anda.

GET /courier/v2/rates

Query Parameter

Parameter	Tipe	Wajib	Keterangan
origin_district_code	string	tidak	Kode kecamatan asal. Wajib jika sender_address_id tidak dikirim.
sender_address_id	string	tidak	ID alamat pengirim tersimpan. Wajib jika origin_district_code tidak dikirim.
destination_district_code	string	ya	Kode kecamatan tujuan (dari endpoint Lokasi).
weight	integer	ya	Berat paket dalam gram (min 1).
item_value	integer	tidak	Nilai barang dalam Rupiah (dasar perhitungan asuransi).
insurance	boolean	tidak	Set true untuk menyertakan biaya asuransi pada tarif.
sender_type	string	tidak	Metode pengiriman: picked up (dijemput kurir, default) atau dropped (antar sendiri ke gerai). dropped hanya menampilkan kurir yang menerima drop-off.
length	integer	tidak	Panjang paket (cm) untuk perhitungan berat volumetrik.
width	integer	tidak	Lebar paket (cm).
height	integer	tidak	Tinggi paket (cm).

Contoh Request

cURL

curl -X GET 'https://use.api.co.id/courier/v2/rates?origin_district_code=3374010&destination_district_code=3173040&weight=1000' \
  -H 'x-api-co-id: YOUR_API_KEY'

JavaScript

const res = await fetch('https://use.api.co.id/courier/v2/rates?origin_district_code=3374010&destination_district_code=3173040&weight=1000', {
  method: 'GET',
  headers: {
    'x-api-co-id': 'YOUR_API_KEY',
  },
});
const data = await res.json();

Python

import requests

res = requests.get(
    "https://use.api.co.id/courier/v2/rates",
    params={"origin_district_code":"3374010","destination_district_code":"3173040","weight":"1000"},
    headers={"x-api-co-id": "YOUR_API_KEY"},
)
data = res.json()

Contoh Response

{
  "is_success": true,
  "message": "OK",
  "data": {
    "quote_id": "qt_9f2a7c1b8e3d4a5f",
    "rates": [
      {
        "courier_code": "ninja",
        "courier_name": "Ninja Xpress",
        "courier_image": "https://use.api.co.id/assets/couriers/ninja.png",
        "service_code": "STANDARD",
        "service_name": "Standard",
        "service_type": "regular",
        "etd": "2 - 3 hari",
        "est": "2026-08-10",
        "is_cod": false,
        "normal_price": 12000,
        "is_cheapest": true,
        "is_fastest": false,
        "price": 12000,
        "handling_fee": 2000,
        "insurance_fee": 0,
        "total_price": 14000
      }
    ]
  }
}

• Simpan quote_id — ia diperlukan saat membuat order agar harga terkunci.
• Jika saldo tidak cukup untuk biaya Rp 5, endpoint mengembalikan 402.
• Kirim origin_district_code atau sender_address_id; salah satu wajib ada.
• Metode pengiriman (sender_type) melekat pada quote_id. Untuk dropped, picked_up_time tidak diperlukan saat membuat order. Cek dukungan drop-off tiap kurir lewat sender_types di endpoint Daftar Kurir.

info

COD (bayar di tempat) segera hadir. Untuk saat ini semua tarif dan order bersifat non-COD (is_cod: false).

Coba langsung

• GET/courier/v2/ratesShipping Rates