Track parcels (billable)

Track up to 5 parcels at once. Average response time 5 seconds per item. Supports 500+ carriers including USPS, UPS, FedEx, DHL, and more.

Some carriers are limited to 1 item per request:

The carriers listed below take substantially longer to look up, so a single synchronous request may contain at most 1 item across all of them combined — mixing two of them in one request is rejected as well. You can still batch them with other carriers: 1 item from this list + up to 4 items from any other carrier = 5 items total.

us.ups, us.usps, us.fedex, us.dhl, us.dhl.express, us.dhl.ecommerce, intl.ups, intl.usps, intl.fedex, intl.dhl, gb.royalmail, gb.royalmail.special, gb.evri, gb.ups, ca.ups, ca.fedex, de.ups, es.ups, ie.ups, au.post

This list may change. Exceeding the limit returns INVALID_REQUEST, and the error message names the exact carriers that triggered it. To track several items from these carriers, use /v2/webhooks/register (up to 100 items, asynchronous).

Events without a time: some carriers give only a date for certain events and no scan time (USPS does this for "In Transit to Next Facility" and "Pre-Shipment"). In that case timestamp is filled with noon on that date to stay valid ISO 8601, and the event carries timeUnknown: true. When the field is absent, the time came from the carrier and is real.

When to use this endpoint: Use /v2/track for on-demand, one-off lookups — for example, when a customer checks their order status on your website.

For continuous monitoring, use Webhooks instead. If you need to keep your database in sync with delivery status (e.g., updating order records, triggering notifications), register a webhook subscription via /v2/webhooks/register with recurring: true. The webhook approach is far more efficient — instead of polling repeatedly, you receive a push notification only when the status actually changes.

Rate Limits: Each API key has per-minute and per-month request quotas based on your plan. When exceeded, the API returns HTTP 429. See response headers X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset for current usage.