Get real-time tracking updates, delivery status, and shipment events for all your orders.
The Tracking API provides real-time visibility into shipment status, location updates, and delivery events. Track packages from warehouse to doorstep with detailed event history and estimated delivery times.
Live tracking events as they happen
Complete shipment journey data
Accurate delivery estimates
/tracking/:tracking_numberRetrieve complete tracking information including current status, location history, and delivery estimates.
curl -X GET "https://app.3plship.com/api/v1/tracking/1Z999AA10123456784" \
-H "Authorization: Bearer zl_live_abc123..."const response = await fetch(
'https://app.3plship.com/api/v1/tracking/1Z999AA10123456784',
{
headers: {
'Authorization': 'Bearer zl_live_abc123...'
}
}
);
const data = await response.json();import requests
response = requests.get(
'https://app.3plship.com/api/v1/tracking/1Z999AA10123456784',
headers={'Authorization': 'Bearer zl_live_abc123...'}
)
data = response.json(){
"success": true,
"data": {
"tracking_number": "1Z999AA10123456784",
"status": "in_transit",
"carrier": "UPS",
"service_type": "Ground",
"estimated_delivery": "2025-01-15T17:00:00.000Z",
"current_location": {
"city": "Chicago",
"state": "IL",
"country": "US",
"facility": "UPS Distribution Center"
},
"events": [
{
"timestamp": "2025-01-12T14:30:00.000Z",
"status": "in_transit",
"location": {
"city": "Chicago",
"state": "IL"
},
"description": "Package arrived at facility"
},
{
"timestamp": "2025-01-12T08:15:00.000Z",
"status": "picked_up",
"location": {
"city": "Indianapolis",
"state": "IN"
},
"description": "Package picked up by carrier"
}
],
"shipment_details": {
"weight": "2.5",
"weight_unit": "lbs",
"dimensions": {
"length": 12,
"width": 8,
"height": 6,
"unit": "in"
}
}
},
"meta": {
"timestamp": "2025-01-12T15:30:45.123Z"
}
}/tracking/batchTrack up to 100 shipments in a single API call for efficient bulk tracking.
{
"tracking_numbers": [
"1Z999AA10123456784",
"1Z999AA10123456785",
"1Z999AA10123456786"
]
}| Status | Description |
|---|---|
pending | Label created, awaiting pickup |
picked_up | Package picked up by carrier |
in_transit | Package is on the way |
out_for_delivery | Package is out for delivery today |
delivered | Package successfully delivered |
exception | Delivery exception occurred |
returned | Package returned to sender |
Instead of polling the tracking API, subscribe to tracking webhooks to receive automatic updates when shipment status changes.
Learn about Webhooks