Live Order Tracking
Prod Env
https://v1.dev.bukalombok.com
Prod Env
https://v1.dev.bukalombok.com
GET
/v1/courier/live
API Documentation: Get Live Tracking & ETA
📍 1. GET Live Tracking Location
Endpoint
GET /v1/courier/liveAuthorization
| Type | Description |
|---|---|
| Bearer Token | INTERNAL_COURIER, SUPER_ADMIN, DELIVERY_COURIER, PICKUP_COURIER, SP_ADMIN, CUSTOMER, VENDOR |
Query Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
courierId | string | Optional | ID kurir untuk melihat lokasi kurir tertentu | f7eef142-a993-472a-a698-18f9271b61eb |
orderShipmentId | string | Optional | ID shipment untuk tracking paket | 43d7bbde-6649-4ffc-ab4d-e84c031859e5 |
shipmentId | string | Optional | Alias untuk orderShipmentId | 43d7bbde-6649-4ffc-ab4d-e84c031859e5 |
trackingNumber | string | Optional | Nomor tracking untuk customer track paket | BL20260111456637 |
Note: Hanya perlu satu parameter: courierIdATAUorderShipmentId/shipmentIdATAUtrackingNumber
Shipment Status Values
| Status | Description |
|---|---|
PENDING | Menunggu proses |
READY | Siap dikirim |
PICKED_UP | Sudah diambil kurir |
IN_TRANSIT | Dalam perjalanan |
OUT_FOR_DELIVERY | Sedang dikirim ke penerima |
DELIVERED | Sudah diterima |
RETURNED | Dikembalikan |
CANCELLED | Dibatalkan |
Priority Values
| Priority | Description |
|---|---|
LOW | Prioritas rendah |
MEDIUM | Prioritas normal |
HIGH | Prioritas tinggi |
Courier Status Values
| Status | Description |
|---|---|
IDLE | Kurir tersedia |
BUSY | Kurir sedang bertugas |
OFFLINE | Kurir offline |
🔐 3. Permission Matrix
| Role | Live Tracking | ETA | Notes |
|---|---|---|---|
CUSTOMER | ✅ (Own shipments only) | ✅ (Own shipments only) | Hanya bisa track shipment milik sendiri |
VENDOR | ✅ (Own shop shipments) | ✅ (Own shop shipments) | Hanya shipment dari tokonya |
DELIVERY_COURIER | ✅ (Assigned shipments) | ✅ (Assigned shipments) | Hanya shipment yang ditugaskan |
PICKUP_COURIER | ✅ (Assigned shipments) | ✅ (Assigned shipments) | Hanya shipment yang ditugaskan |
INTERNAL_COURIER | ✅ (All shipments) | ✅ (All shipments) | Full access |
SP_ADMIN | ✅ (All shipments) | ✅ (All shipments) | Full access |
SUPER_ADMIN | ✅ (All shipments) | ✅ (All shipments) | Full access |
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://v1.dev.bukalombok.com/v1/courier/live?courierId=&orderShipmentId=122febad-e55a-4f31-8d5e-0bbf12f4f746&trackingNumber' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success - Success
{
"meta": {
"success": true,
"status": 200,
"message": "Paket sudah diterima oleh Joko"
},
"data": {
"shipment": {
"status": "DELIVERED",
"priority": "HIGH",
"trackingNumber": "BIN20260121137671ZYO",
"orderNumber": "ORD-TOKOSE-260121-B7484BD8",
"isDelivered": true,
"deliveredAt": "2026-01-21T03:26:34.242Z"
},
"tracking": {
"latitude": 8.639875,
"longitude": 116.444403,
"accuracy": null,
"heading": null
},
"lastUpdated": "2026-01-21T03:26:34.242Z",
"courier": {
"id": "82e6b78f-f4f3-485e-8679-ef69e1d1aa20",
"name": "Rina Kurnia",
"phone": "6281234567106",
"vehicleNumber": "DR 2006 DF"
},
"deliveryProof": {
"hasProof": true,
"photoUrl": "public/shipping-proof/delivery-bin20260121137671zyo-1768965994260-1768965994260-6b77c6.jpeg",
"recipientName": "Joko",
"signatureUrl": null,
"address": "Indonesia, West Nusa Tenggara · Lombok Timur · Sikur",
"deliveredAt": "2026-01-21T03:26:34.242Z"
}
}
}Modified at 2026-01-21 05:12:39