Retrieve a shipment
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.
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>.
shipmentCode*stringThe shipment code from Create an order or List shipments.
^SHP-[0-9]{6}-[A-Z0-9]{6}$The shipment.
application/json- response
statusCode*integermessage*stringdata*curl -X GET 'https://sandbox-api.fastrac.example/b2b/shipments/string/details'{ "statusCode": 200, "message": "Shipment detail retrieved.", "data": { "id": 18452, "code": "SHP-261120-K9M2Q7", "orderId": 9021, "orderCode": "FSO-261120-A1B2C3", "source": "B2B", "userId": 512, "status": "IN_TRANSIT", "type": "REGULAR", "courierServiceId": 12, "courierServiceCode": "REG", "courierServiceName": "JNE Reguler", "courierCode": "JNE", "airwayBill": "CM12345678901", "trackingUrl": null, "etdRange": "2 - 3 Days", "isInsured": true, "shippingDistanceMeter": 0, "finishedAt": null, "createdAt": "2026-11-20T02:05:13.000Z", "price": { "amount": 12500, "currency": "IDR" }, "shippingRateId": 66310, "shippingRateCode": "SR-7KQ2M9XA", "sender": { "name": "Toko Sinar Tebet", "email": "[email protected]", "whatsappNumber": "081211112222", "fullAddress": "Jl. Tebet Raya No. 12, Tebet Barat, Jakarta Selatan", "province": "DKI Jakarta", "city": "Kota Jakarta Selatan", "district": "Tebet", "subdistrict": "Tebet Barat", "postCode": "12810", "createdAt": "2026-11-20T02:05:10.000Z" }, "receivers": [ { "name": "Rina Kartika", "phoneNumber": "081298765432", "fullAddress": "Jl. Braga No. 8, Braga, Sumur Bandung, Kota Bandung", "addressNote": "Rumah pagar hijau, sebelah warung kopi", "label": "Rumah", "province": "Jawa Barat", "city": "Kota Bandung", "district": "Sumur Bandung", "subdistrict": "Braga", "postCode": "40111", "createdAt": "2026-11-20T02:05:10.000Z" } ], "histories": [ { "timestamp": "2026-11-20T02:05:13.000Z", "status": "PENDING_DROPOFF", "description": "Shipment booked with courier" }, { "timestamp": "2026-11-20T08:40:00.000Z", "status": "IN_TRANSIT", "description": "Paket diterima di counter agen" } ], "packageDetails": [ { "id": 30117, "shipmentId": 18452, "shippingRatePackageDetailId": 88104, "shippingRatePackageCode": "PKG-3M8XQ1", "declaredValue": 500000, "packagePhotoUrls": [], "isGlassware": false, "length": 30, "width": 20, "height": 10, "weight": 1200, "actualDimension": 0, "actualWeight": 0, "description": null, "packageNote": "Jangan dibanting" } ], "driverDetails": null }}Was this page helpful?
List shipments GET
Lists your shipments, newest first, with filters and per-status counts. Unpaid shipments are never listed. Use it for an order dashboard, or to find a shipment after a timeout. `data.count` covers all your shipments in the `startDate`–`endDate` range and ignores the other filters. `count.RTS` adds up `RTS_CONFIRMED` and `RTS_TRANSIT`. Requires the `READ_ORDER` permission.
Track a shipment GET
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.