Package Tracking API documentation

Implementation resources

Use the server-side integration guide for downloadable JavaScript and Python examples, timeouts, and failure handling. Review carrier notes, request budgets, and the documentation changelog.

Documentation updated September 11, 2026. Code examples illustrate the documented interface; carrier coverage and live error behavior should be tested with your subscription.

Supported carrier scope

C2W supports UPS, USPS, FedEx, DHL Express, DHL eCommerce, OnTrac, UniUni and GOFO. Use the carrier guides for examples and evaluation notes. Service coverage and field availability vary; examples are illustrative, not live carrier results. Webhooks are not supported.

Quick start

Subscribe to the TrackingPackage API on RapidAPI, copy your application key, and send a request with the parcel’s tracking number.

curl --request GET \
  --url 'https://trackingpackage.p.rapidapi.com/TrackingPackage?trackingNumber=9200190312809701574398' \
  --header 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  --header 'X-RapidAPI-Host: trackingpackage.p.rapidapi.com'

Endpoint

The endpoint returns the current shipment state and an array of carrier tracking events. Requests and responses use HTTPS; successful responses are JSON. Webhooks are not supported. This reference covers one tracking number per request; contact C2W for batch requirements.

Authentication

Send credentials as request headers. The RapidAPI key and host identify your RapidAPI application and route the call to this API. If an additional Authorization value was issued for your integration, send it exactly as provided. Omit that header otherwise.

Request

Query parameters

This is a GET request and does not require a request body. URL-encode the tracking number when building the query string.

JavaScript (Node.js)

const trackingNumber = '9200190312809701574398';
const url = new URL('https://trackingpackage.p.rapidapi.com/TrackingPackage');
url.searchParams.set('trackingNumber', trackingNumber);

const response = await fetch(url, {
  headers: {
    'X-RapidAPI-Key': process.env.RAPIDAPI_KEY,
    'X-RapidAPI-Host': 'trackingpackage.p.rapidapi.com',
    ...(process.env.TRACKING_API_AUTHORIZATION ? { Authorization: process.env.TRACKING_API_AUTHORIZATION } : {})
  }
});

if (!response.ok) {
  throw new Error(`Tracking request failed: ${response.status}`);
}

const tracking = await response.json();
console.log(tracking.Status, tracking.TrackingDetails);

Response object

Field names and capitalization are case-sensitive. Empty or unavailable carrier data may be returned as an empty string or null, so consumers should support both.

Example response

{
  "TrackingNumber": "9200190312809701574398",
  "Delivered": true,
  "Carrier": "USPS",
  "ServiceType": "USPS - USPS Ground Advantage",
  "StatusCode": "Delivered",
  "Status": "Delivered",
  "StatusSummary": "Delivered, In/At Mailbox",
  "DeliveredDateTime": "2026-07-07 15:10:00",
  "DeliveredDateTimeInDateTimeFormat": "2026-07-07T15:10:00",
  "TrackingDetails": [
    {
      "EventDateTime": "2026-07-07 15:10:00",
      "Event": "Delivered, In/At Mailbox",
      "EventAddress": "EUGENE OR",
      "State": "OR",
      "City": "EUGENE",
      "Zip": "",
      "EventDateTimeInDateTimeFormat": "2026-07-07T15:10:00"
    }
  ]
}

Tracking event object

Error handling

Check the HTTP status before parsing a successful tracking response. RapidAPI may return its own error payload for authentication, quota, or routing failures; application-level errors may use a different JSON shape from the success object.

Integration notes

• Store tracking numbers as strings, not numeric types.
• Treat empty strings and null as unavailable values.
• Times in the sample response include no UTC offset or timezone. Avoid converting them as UTC unless your integration contract confirms that behavior.
• Trim location strings before display or comparison.
• Do not infer a complete list of possible StatusCode or event values from one carrier response.
• Cache or poll according to your RapidAPI plan limits; avoid tight polling loops.