Get Shipment Details

Retrieve the full detail record of a specific shipment by its internal ID or tracking code.

---

Endpoints

There are two ways to retrieve the complete details of a shipment:

1. By Shipment ID

GET/v1/shipments/:id

Required permission: shipments:get

2. By Tracking Code

GET/v1/shipments/tracking/:code

Required permission: shipments:get

---

Path Parameters

Parameter	Type	Required	Description
id	String	✅	The internal shipment ID (e.g. SHP_Z8F9A2B3C4).
code	String	✅	The customer-facing tracking code (e.g. GDJJETYEJ).

---

Response

Returns the complete shipment record including pricing breakdown and event history.

Field	Type	Description
id	String	Internal shipment ID.
trackingCode	String	Customer-facing tracking code.
senderName	String	Sender's full name.
senderPhone	String	Sender's phone number.
senderEmail	String?	Sender's email, if provided.
receiverName	String	Recipient's full name.
receiverPhone	String	Recipient's phone number.
receiverEmail	String?	Recipient's email, if provided.
originAddress	String	Resolved origin street address.
destinationAddress	String	Resolved destination street address.
packageTitle	String	Package label.
packageDescription	String?	Package description, if provided.
packageCategory	String	Size tier. SMALL, MEDIUM, LARGE, or EXTRA_LARGE.
itemValue	Float?	Declared item value in ₦, if provided.
enableInsurance	Boolean?	Whether insurance coverage was enabled.
distanceKm	Float	Route distance in kilometers.
baseFare	Integer	Flat base charge in ₦.
distanceFee	Integer	Distance-based charge in ₦.
weightSurcharge	Integer	Weight-tier surcharge in ₦.
valueSurcharge	Integer	Insurance surcharge in ₦.
totalCost	Integer	Total amount deducted from the wallet in ₦.
status	String	Current status. PENDING, SCHEDULED, CANCELED, or DELIVERED.
note	String?	Internal operator note, if attached.
userNote	String?	Note left by the sender, if provided.
createdAt	String	ISO 8601 creation timestamp.

---

{
"statusCode": 200,
"message": "Success",
"data": {
  "id": "SHP_Z8F9A2B3C4",
  "trackingCode": "TCL-SB-3891829",
  "senderName": "Grace Adegoke",
  "senderPhone": "+2348031234567",
  "senderEmail": "grace@marketify.ng",
  "receiverName": "John Doe",
  "receiverPhone": "+2348123456789",
  "originAddress": "12 Allen Avenue, Ikeja, Lagos",
  "destinationAddress": "Ring Road, Ibadan, Oyo",
  "packageTitle": "Laptop & Charger",
  "packageCategory": "MEDIUM",
  "itemValue": 450000,
  "enableInsurance": true,
  "distanceKm": 135.2,
  "baseFare": 1000,
  "distanceFee": 27040,
  "weightSurcharge": 500,
  "valueSurcharge": 4500,
  "totalCost": 33040,
  "status": "PENDING",
  "createdAt": "2026-07-01T17:42:00Z"
}
}