Skip to main content
POST
/
api
/
v1
/
tracking
/
batch
{
  "trackingNumbers": [
    "CBECUSD123456789",
    "CBECUSD123456790",
    "CBECUSD123456791",
    "INVALID123456789"
  ],
  "includeHistory": false
}

{
  "success": true,
  "results": [
    {
      "trackingNumber": "CBECUSD123456789",
      "status": "IN_TRANSIT",
      "statusName": "In Transit",
      "estimatedDelivery": "2024-12-28T18:00:00Z"
    },
    {
      "trackingNumber": "CBECUSD123456790",
      "status": "DELIVERED",
      "statusName": "Delivered",
      "deliveredAt": "2024-12-26T14:30:00Z"
    },
    {
      "trackingNumber": "CBECUSD123456791",
      "status": "OUT_FOR_DELIVERY",
      "statusName": "Out for Delivery"
    }
  ],
  "notFound": ["INVALID123456789"]
}
Retrieves tracking information for up to 100 parcels in a single request. More efficient than making individual requests.

​
Request Body

​
trackingNumbers
array
required
List of tracking numbers to look up (1-100 items).
​
includeHistory
boolean
default:"false"
Set to true to include tracking history for each parcel.

​
Response

​
success
boolean
Whether the request succeeded
​
results
array
Tracking information for found parcels
​
notFound
array
Tracking numbers that were not found in the system
{
  "trackingNumbers": [
    "CBECUSD123456789",
    "CBECUSD123456790",
    "CBECUSD123456791",
    "INVALID123456789"
  ],
  "includeHistory": false
}

{
  "success": true,
  "results": [
    {
      "trackingNumber": "CBECUSD123456789",
      "status": "IN_TRANSIT",
      "statusName": "In Transit",
      "estimatedDelivery": "2024-12-28T18:00:00Z"
    },
    {
      "trackingNumber": "CBECUSD123456790",
      "status": "DELIVERED",
      "statusName": "Delivered",
      "deliveredAt": "2024-12-26T14:30:00Z"
    },
    {
      "trackingNumber": "CBECUSD123456791",
      "status": "OUT_FOR_DELIVERY",
      "statusName": "Out for Delivery"
    }
  ],
  "notFound": ["INVALID123456789"]
}

​
Use Cases

Dashboard Updates

Refresh status for all parcels on a customer’s order page

Manifest Tracking

Check status of all parcels in a shipment

Bulk Operations

Monitor large batches of orders

Scheduled Syncs

Periodic sync of parcel statuses to your database

​
Rate Limits

Batch tracking counts as a single request for rate limiting, but has a higher weight:
Request SizeRate Limit Impact
1-10 parcels1 request
11-50 parcels2 requests
51-100 parcels5 requests
For high-volume tracking, consider setting up webhooks to receive real-time updates instead of polling.