API ReferenceTracking

Get Tracking by Tracking IDs

View as MarkdownOpen in Claude

Retrieves tracking information for one or more shipments by their carrier tracking IDs. Returns the current status, carrier details, estimated delivery time, and full tracking history for each tracking ID. Intended for platform-level consumers that reference shipments by carrier tracking number rather than ShipBob shipment ID.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Query parameters

TrackingIdsstringOptional
A list of carrier tracking IDs to retrieve tracking information for

Response

OK
carrierstring or null

The name of the carrier handling the shipment (e.g., UPS, FedEx, USPS)

carrier_messagestring or null
The raw status message provided by the carrier
carrier_tracking_numberstring or null
The tracking number assigned by the carrier
etadatetime or null
The estimated date and time of delivery
historylist of objects or null
A list of historical tracking events for the shipment
last_updateddatetime or null
The date and time when the tracking information was last updated
locationstring or null
The current geographic location of the shipment
messagestring or null

A human-readable message describing the current shipment status

public_tracking_urlstring or null
A publicly accessible URL for tracking the shipment on the carrier's website
servicestring or null

The carrier service level used for the shipment (e.g., Ground, Express)

statusenum or null

The current high-level status of the shipment

substatusstring or null

A more granular status code describing the current state of the shipment. Possible values include: ‘Delivered’, ‘Failed Attempt’, ‘In Transit’, ‘Delayed’, ‘Label created’, etc.

tracking_idstring or null
The unique tracking identifier assigned to the shipment

Errors