Order tracking only works for Amazon orders right now. Support for Shopify orders coming soon.
This guide covers how to retrieve tracking information for physical items purchased through Crossmint’s Agentic Commerce platform.

​
API Endpoint

The Order Tracking API provides real-time delivery information for physical item orders. 
GET /api/unstable/orders/{orderId}/tracking
You can get the orderId from the response of the Create Order endpoint.

​
Example Request

const baseUrl = "staging"; // or 'www' for prod environment
const response = await fetch(`https://${baseUrl}.crossmint.com/api/unstable/orders/${orderId}/tracking`, {
    method: "GET",
    headers: {
        // API key requires `orders.read` scope.
        "X-API-KEY": `${API_KEY}`,
        "Content-Type": "application/json",
    },
});

const trackingData = await response.json();
console.log("Tracking information:", trackingData);

​
Example Response

[
    {
        "status": "shipped",
        "packageTracking": {
            "carrierName": "Amazon",
            "carrierTrackingNumber": "TBA123456789"
        },
        "deliveryTimeRange": {
            "lowerBound": "2025-08-16T12:28:34.97Z",
            "upperBound": "2025-08-16T18:28:34.97Z"
        }
    }
]

​
Response Fields

  • status: Current delivery status of the package
    • pending: Package is being prepared for shipment
    • shipped: Package is in transit
    • delivered: Package has been delivered to the recipient (only guaranteed for Amazon packages when carrierName is “Amazon”)
  • packageTracking (optional): Carrier tracking information when available
    • carrierName: Name of the shipping carrier (e.g., “Amazon”)
    • carrierTrackingNumber: Tracking number provided by the carrier (starts with “TBA” for Amazon)
  • deliveryTimeRange (optional): Expected or actual delivery time window
    • lowerBound: Start of delivery time range (ISO 8601 format)
    • upperBound: End of delivery time range (ISO 8601 format)
If the package is in delivered state, lowerBound is equal to upperBound and it’s just the time the package arrived