Dokumentasi API

Lacak resi dari aplikasimu lewat satu endpoint sederhana.

Akses API memerlukan API key berbayar.

Autentikasi

Kirim API key lewat header x-api-key, atau parameter apikey di URL.

Lacak resi

GET /v1/track
ParameterKeterangan
resiNomor resi. Wajib.
courierKode kurir. Opsional, dideteksi otomatis bila memungkinkan.
hp5 digit terakhir nomor HP penerima. Opsional, dibutuhkan beberapa kurir.

Contoh permintaan

curl "/v1/track?resi=SPXID012345678901" \
  -H "x-api-key: ck_xxxxxxxx"
const r = await fetch("/v1/track?resi=SPXID012345678901", {
  headers: { "x-api-key": "ck_xxxxxxxx" }
});
console.log(await r.json());
import requests

r = requests.get(
    "/v1/track",
    params={"resi": "SPXID012345678901"},
    headers={"x-api-key": "ck_xxxxxxxx"},
)
print(r.json())

Contoh respons

{
  "status": true,
  "resi": "SPXID012345678901",
  "courier": "SPX Express",
  "delivery_status": "Terkirim",
  "info": { "Tujuan": "Jakarta" },
  "last_update": { "date": "30/10/2026 14:20", "description": "Paket diterima" },
  "history": [
    { "date": "30/10/2026 14:20", "description": "Paket diterima" }
  ]
}

Jika kurir belum terdeteksi, respons berisi need_courier: true dan daftar options. Jika kurir meminta nomor HP, respons berisi need_hp: true.

Kuota dan header

Setiap permintaan mengurangi kuota bulanan. Sisa kuota dikirim lewat header X-Quota-Limit dan X-Quota-Remaining.

Kode error

KodeArti
400Nomor resi tidak valid.
401API key tidak ada atau tidak valid.
402Langganan sudah kedaluwarsa.
429Kuota bulan ini habis.