Track a shipment
Asks the courier for the latest tracking events and returns them merged with the stored history. If the courier reports a new status, the shipment is updated (and the matching webhook is sent) as part of this call. If the courier can't be reached, the stored history is returned.
Pass either the shipment code or the courier's airway bill. A shipment can be tracked only after the courier has assigned an airway bill.
Prefer webhooks for status changes; call this when a user opens a tracking page.
Requires the READ_ORDER permission.
bearerAuthAuthorizationBearer <token>An access token from the OAuth2 client-credentials grant. Exchange your API key
(client_id + client_secret) at the token endpoint and send
Authorization: Bearer <access_token>.
trackingCode*stringA shipment code (SHP-…) or the courier's airway bill.
Current status and full tracking history, oldest event first.
application/json- response
statusCode*integermessage*stringdata*curl -X GET 'https://sandbox-api.fastrac.example/b2b/shipments/track/string'{ "statusCode": 200, "message": "Request successful.", "data": { "currentStatus": "IN_TRANSIT", "trackingUrl": null, "courier": "JNE", "service": "JNE Reguler", "histories": [ { "timestamp": "2026-11-20T03:12:00.000Z", "status": "PENDING_DROPOFF", "description": "Shipment created, waiting for drop-off" }, { "timestamp": "2026-11-20T08:40:00.000Z", "status": "IN_TRANSIT", "description": "Paket diterima di counter agen", "location": "JAKARTA SELATAN" }, { "timestamp": "2026-11-20T21:05:00.000Z", "status": "IN_TRANSIT", "description": "Paket diberangkatkan ke kota tujuan", "location": "JAKARTA" } ] }}Was this page helpful?
Retrieve a shipment GET
Returns everything about one shipment: status, courier service, airway bill, sender and receivers with their region names, packages (with measured weight once the courier reweighs), status history and driver details. This reads stored data; to ask the courier for the latest status, use **Track a shipment**. Requires the `READ_ORDER` permission. You can only read your own shipments.
Cancel a shipment POST
Cancels one shipment and refunds what was paid for it to where the payment came from. Before the courier has an airway bill, the shipment is cancelled immediately. After that, the courier is asked to cancel first; if the courier refuses (for example because the parcel is already picked up), the error is returned and nothing changes. Calling it again on a cancelled shipment succeeds without doing anything. Delivered shipments and shipments already being returned to the sender can't be cancelled. Requires the `CANCEL_ORDER` permission. No request body.