For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentationAPI Reference
DocumentationAPI Reference
  • API Reference
      • GETGet Tracking by Shipment Ids
      • GETGet Tracking by Tracking Ids
    • OpenAPI spec
LogoLogo
API ReferenceTracking

Get Tracking by Tracking Ids

||View as Markdown|
GET
/2026-01/tracking
GET
/2026-01/tracking
$curl -G https://api.shipbob.com/2026-01/tracking \
>     -H "Authorization: Bearer <token>" \
>     -d TrackingIds=string
1[
2  {
3    "current_status": "InTransit",
4    "current_timestamp": "2025-09-24T09:45:00+00:00",
5    "tracking_number": "SBAAAA01234567890",
6    "carrier": "ShipBob",
7    "current_substatus": "In Transit",
8    "current_substatus_code": "InTransit_001",
9    "edd": "2025-09-28T15:00:00+00:00",
10    "edd_source": "carrier",
11    "history": [
12      {
13        "address": {
14          "city": "Los Angeles",
15          "country": "US",
16          "latitude": 34.0522,
17          "location": "Los Angeles, CA",
18          "longitude": -118.2437,
19          "postal_code": "90001",
20          "state": "CA"
21        },
22        "status": "InTransit",
23        "substatus": "In Transit",
24        "substatus_code": "InTransit_001",
25        "timestamp": "2025-09-24T09:45:00+00:00"
26      }
27    ],
28    "last_mile_carrier": {
29      "carrier": "UPS",
30      "service": "UPS Ground",
31      "tracking_number": "1Z999AA10123456784",
32      "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784"
33    },
34    "service": "Standard",
35    "shipment_id": 10234510234,
36    "tracking_url": "https://www.track.shipbob.com/SBAAAA01234567890"
37  }
38]

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.

Was this page helpful?
Previous

Get Tracking by Shipment Ids

Next

Simulates Shipment

Built with

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token or OAuth2

Query parameters

TrackingIdslist of stringsOptional
A list of carrier tracking Ids to retrieve tracking information for

Response

OK
current_statusstring

The current high-level status of the shipment.

current_timestampdatetime
The date and time of the most recent tracking event.
tracking_numberstring

The tracking number for the shipment. For ShipBob-carried shipments this is the ShipBob tracking number; for last-mile carrier shipments it is the carrier tracking number.

carrierstring

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

current_substatusstring

A human-readable label for the current granular status (e.g., ‘In Transit’).

current_substatus_codestring

A machine-readable code for the current granular status (e.g., ‘InTransit_001’).

delivery_signed_bystring
The name of the person who signed for the delivery, if applicable.
edddatetime
The estimated delivery date and time.
edd_sourcestring

The source of the estimated delivery date. Either ‘carrier’ (from carrier data) or ‘shipbob’ (ShipBob estimate).

historylist of objects

A list of historical tracking events for the shipment, ordered oldest-first.

last_mile_carrierobject

Last-mile carrier details. Fields are null when no last-mile carrier is present.

proof_of_delivery_urlslist of strings

URLs to proof-of-delivery images, if available.

servicestring

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

shipment_idlong
The unique identifier of the shipment in ShipBob's system.
tracking_urlstring
A publicly accessible URL for tracking the shipment.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
500
Internal Server Error