API ReferenceTracking

Get Tracking by Shipment IDs

View as MarkdownOpen in Claude
Retrieves tracking information for one or more shipments by their ShipBob shipment IDs. Returns the current status, carrier details, estimated delivery time, and full tracking history for each shipment. Accepts between 1 and 25 shipment IDs per request.

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

OR
AuthorizationBearer
OAuth2 authentication using JWT tokens

Query parameters

ShipmentIdsstringOptional
A list of ShipBob shipment 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)

shipment_idlong or null
The unique identifier of the shipment in ShipBob's system
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