Tracking API

Retrieve tracking information for any shipment.

Get tracking

GET /v1/tracking/:trackingNumber

Path parameters

Parameter	Type	Description
trackingNumber	string	The carrier tracking number

Query parameters

Parameter	Type	Description
carrier	string	Carrier code (optional, auto-detected if omitted)

Response

{
  "trackingNumber": "9400111899223456789012",
  "carrier": "usps",
  "service": "priority",
  "status": "in_transit",
  "substatus": "in_transit_to_destination",
  "estimatedDelivery": "2026-03-12T17:00:00Z",
  "from": { "city": "Denver", "state": "CO", "country": "US" },
  "to": { "city": "Portland", "state": "OR", "country": "US" },
  "weight": { "oz": 16 },
  "events": [
    {
      "timestamp": "2026-03-10T14:30:00Z",
      "status": "in_transit",
      "description": "Arrived at USPS Regional Facility",
      "location": { "city": "Salt Lake City", "state": "UT", "country": "US" }
    }
  ],
  "updatedAt": "2026-03-10T14:30:00Z"
}

Batch tracking

POST /v1/tracking/batch

Track up to 100 tracking numbers in a single request:

{
  "trackingNumbers": [
    "9400111899223456789012",
    "1Z999AA10123456784"
  ]
}