Skip to main content
Once an order has been placed with a retailer, tracking information becomes available as shipments are dispatched. Tracking numbers are automatically extracted from retailer shipping notifications and associated with your order.

​
How Tracking Works

  1. Your order is successfully placed with the retailer
  2. The retailer ships the item and sends a shipping notification
  3. We automatically extract tracking numbers from the notification
  4. Tracking information appears in the order response
Tracking numbers are added to orders automatically. There is no separate endpoint to create or manage tracking numbers.

​
Tracking in Order Response

Tracking information is returned as part of the order response when you retrieve an order: 
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "tracking_numbers": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    }
  ],
  ...
}

​
Tracking Number Fields

FieldTypeDescription
idstring (UUID)Unique identifier for the tracking record
carrierstringShipping carrier (see supported carriers below)
tracking_numberstringThe carrier’s tracking number
created_atstring (ISO 8601)When the tracking number was extracted

​
Supported Carriers

The following carriers are automatically detected:
Carriercarrier valueExample Format
UPSups1Z999AA10123456784
FedExfedex123456789012
USPSusps9400111899223033005001
Amazon LogisticsamazonTBA123456789000
DHLdhl1234567890

​
Multiple Tracking Numbers

An order may have multiple tracking numbers if:
  • Items ship separately from the retailer
  • Multiple products in the order ship from different fulfillment centers
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "tracking_numbers": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "carrier": "ups",
      "tracking_number": "1Z999AA10123456784",
      "created_at": "2026-01-15T14:30:00Z"
    },
    {
      "id": "8d0f7780-8536-51ef-055c-f18fd2g01bf8",
      "carrier": "amazon",
      "tracking_number": "TBA123456789000",
      "created_at": "2026-01-16T09:15:00Z"
    }
  ]
}
You can construct tracking URLs for each carrier:
CarrierTracking URL
UPShttps://www.ups.com/track?tracknum={tracking_number}
FedExhttps://www.fedex.com/fedextrack/?trknbr={tracking_number}
USPShttps://tools.usps.com/go/TrackConfirmAction?tLabels={tracking_number}
Amazonhttps://www.amazon.com/progress-tracker/package/?trackingId={tracking_number}
DHLhttps://www.dhl.com/us-en/home/tracking.html?tracking-id={tracking_number}

​
When Tracking Is Available

Tracking numbers appear after the order status changes to order_placed and the retailer has shipped the item. The timing depends on:
  • Retailer processing time
  • Shipping method selected
  • Product availability
Tracking numbers may not be available immediately after an order is placed. Check the order periodically to retrieve tracking information once items have shipped. Webhook events for tracking and shipping notifications are coming soon.