API Hub/Track Shipments
    FedEx · UPS · DHL

    Track Shipments

    Pull real-time tracking events for any shipment using its tracking number, no carrier portal needed.

    Prerequisites: FedEx and UPS require a Bearer token. DHL uses your API key header. See the Carrier Credentials page for setup and auth steps.

    Endpoint at a Glance

    POSThttps://apis.fedex.com/track/v1/trackingnumbers
    AuthBearer token: see prerequisites page
    Status fieldoutput.completeTrackResults[0].trackResults[0].latestStatusDetail.description

    FedEx: Full Example

    Reusing your access token: FedEx tokens expire and fetching a new one on every request wastes time and hits rate limits. Use the get_fedex_token() caching helper from the Carrier Credentials → Token Caching guide - it returns a live token without re-authenticating unless it's about to expire.
    POST https://apis.fedex.com/track/v1/trackingnumbers
    Authorization: Bearer YOUR_ACCESS_TOKEN
    Content-Type: application/json
    
    {
      "includeDetailedScans": true,
      "trackingInfo": [
        {
          "trackingNumberInfo": {
            "trackingNumber": "449044304137821"
          }
        }
      ]
    }
    
    // Response (simplified):
    {
      "output": {
        "completeTrackResults": [{
          "trackingNumber": "449044304137821",
          "trackResults": [{
            "latestStatusDetail": {
              "code": "DL",
              "description": "Delivered",
              "scanLocation": { "city": "Los Angeles", "stateOrProvinceCode": "CA" }
            },
            "dateAndTimes": [
              { "type": "ACTUAL_DELIVERY", "dateTime": "2026-04-15T14:32:00-07:00" }
            ],
            "scanEvents": [{
              "date": "2026-04-15T14:32:00-07:00",
              "eventType": "DL",
              "eventDescription": "Delivered",
              "scanLocation": { "city": "Los Angeles", "stateOrProvinceCode": "CA", "countryCode": "US" }
            }]
          }]
        }]
      }
    }

    Tips

    • FedEx: Pass up to 30 tracking numbers in a single request by adding more objects to the trackingInfo array.
    • UPS: Pass optional headers transId and transactionSrc for end-to-end request tracing.
    • DHL: Use trackingView=all-checkpoints for the full event history.
    • Scan events are returned in reverse chronological order (newest first) for all three carriers.