Shipment Tracking

Look up real-time tracking information for shipments by tracking number. This endpoint queries the carrier for the latest tracking events and delivery status.

Tracking Lookup

GET/api/shipment-tracking/:trackingNumber

Look up tracking information by tracking number.

Requiredshipments:read

Returns tracking details for a shipment identified by its tracking number. The response includes the current status, carrier information, and a chronological list of tracking events.

Path Parameters

Parameter	Type	Description
`trackingNumber`	string	The carrier tracking number

Query Parameters

Parameter	Type	Description
`carrier`	string	Carrier code hint (optional, auto-detected if omitted)


curl -X GET "https://api.orderly.dev/api/shipment-tracking/794644790132" \
  -H "Authorization: Bearer ord_sk_..."

Response


{
  "data": {
    "tracking_number": "794644790132",
    "carrier": "fedex",
    "service": "FedEx Ground Home Delivery",
    "status": "in_transit",
    "estimated_delivery": "2026-01-18",
    "ship_date": "2026-01-15",
    "origin": {
      "city": "Newark",
      "state": "NJ",
      "country": "US"
    },
    "destination": {
      "city": "Los Angeles",
      "state": "CA",
      "country": "US"
    },
    "events": [
      {
        "timestamp": "2026-01-16T14:30:00Z",
        "status": "in_transit",
        "description": "In transit",
        "location": { "city": "Indianapolis", "state": "IN", "country": "US" }
      },
      {
        "timestamp": "2026-01-15T18:00:00Z",
        "status": "in_transit",
        "description": "Departed FedEx location",
        "location": { "city": "Newark", "state": "NJ", "country": "US" }
      },
      {
        "timestamp": "2026-01-15T10:30:00Z",
        "status": "label_created",
        "description": "Shipment information sent to FedEx",
        "location": { "city": "Newark", "state": "NJ", "country": "US" }
      }
    ],
    "shipment_id": "uuid"
  }
}

Error Responses

Status	Description
`404`	Tracking number not found or not yet in carrier system
`400`	Invalid tracking number format