Track Shipments
Pull real-time tracking events for any shipment using its tracking number, no carrier portal needed.
Prerequisites: FedEx and UPS require a Bearer token. DHL uses your API key header. See the Carrier Credentials page for setup and auth steps.
Endpoint at a Glance
POSThttps://apis.fedex.com/track/v1/trackingnumbers
AuthBearer token: see prerequisites page
Status field
output.completeTrackResults[0].trackResults[0].latestStatusDetail.descriptionFedEx: Full Example
Reusing your access token: FedEx tokens expire and fetching a new one on every request wastes time and hits rate limits. Use the
get_fedex_token() caching helper from the Carrier Credentials → Token Caching guide - it returns a live token without re-authenticating unless it's about to expire.POST https://apis.fedex.com/track/v1/trackingnumbers
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
{
"includeDetailedScans": true,
"trackingInfo": [
{
"trackingNumberInfo": {
"trackingNumber": "449044304137821"
}
}
]
}
// Response (simplified):
{
"output": {
"completeTrackResults": [{
"trackingNumber": "449044304137821",
"trackResults": [{
"latestStatusDetail": {
"code": "DL",
"description": "Delivered",
"scanLocation": { "city": "Los Angeles", "stateOrProvinceCode": "CA" }
},
"dateAndTimes": [
{ "type": "ACTUAL_DELIVERY", "dateTime": "2026-04-15T14:32:00-07:00" }
],
"scanEvents": [{
"date": "2026-04-15T14:32:00-07:00",
"eventType": "DL",
"eventDescription": "Delivered",
"scanLocation": { "city": "Los Angeles", "stateOrProvinceCode": "CA", "countryCode": "US" }
}]
}]
}]
}
}Tips
- FedEx: Pass up to 30 tracking numbers in a single request by adding more objects to the
trackingInfoarray. - UPS: Pass optional headers
transIdandtransactionSrcfor end-to-end request tracing. - DHL: Use
trackingView=all-checkpointsfor the full event history. - Scan events are returned in reverse chronological order (newest first) for all three carriers.
