Tracking new

Retrieve real-time tracking events for any shipment.

Get Tracking Info

GET /v1/tracking/:tracking_number

Returns real-time tracking events for a given tracking number. Works across all supported carriers — no need to specify the carrier.

curl https://api.orbiscommerce.com/v1/tracking/9400111899223456789012 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "tracking_number": "9400111899223456789012",
  "carrier": "usps",
  "status": "in_transit",
  "estimated_delivery": "2025-06-03T20:00:00Z",
  "events": [
    {
      "status": "in_transit",
      "description": "Departed USPS Regional Facility",
      "location": "Los Angeles, CA",
      "occurred_at": "2025-06-02T04:15:00Z"
    },
    {
      "status": "accepted",
      "description": "Package accepted at post office",
      "location": "Los Angeles, CA 90001",
      "occurred_at": "2025-06-01T16:45:00Z"
    }
  ]
}

Tracking Statuses

StatusDescription
pre_transitLabel created, not yet scanned by carrier
acceptedCarrier has accepted the package
in_transitPackage is moving through the carrier network
out_for_deliveryPackage is out for delivery today
deliveredPackage has been delivered
exceptionDelivery exception — action may be required
returnedPackage is being returned to sender