fedex.com APIfedex.com ↗
Access FedEx shipment tracking, address validation, country data, and location search via 4 endpoints. Get event history, delivery estimates, and more.
curl -X GET 'https://api.parse.bot/scraper/9ed4e97f-a431-48ab-93c9-b3fb85713a29/track_by_tracking_number' \ -H 'X-API-Key: $PARSE_API_KEY'
Track a FedEx shipment by tracking number. Returns shipment status, estimated delivery date, and event history.
| Param | Type | Description |
|---|---|---|
| tracking_numberrequired | string | FedEx tracking number |
{
"type": "object",
"fields": {
"output": "object",
"transactionId": "string"
},
"sample": {
"output": {
"complete": true,
"trackingNumber": "774212513411"
},
"transactionId": "123-456-789"
}
}About the fedex.com API
This API exposes 4 endpoints covering FedEx shipment tracking, address validation, country/territory data, and location search. The track_by_tracking_number endpoint returns full event history, current shipment status, and estimated delivery date for any FedEx tracking number. Additional endpoints let you validate postal codes, list all FedEx-supported countries with their currency and shipping capabilities, and find nearby FedEx drop-off and service locations.
Shipment Tracking
The track_by_tracking_number endpoint accepts a single tracking_number string and returns an output object containing shipment status, estimated delivery date, and a timestamped event history. Each response also includes a transactionId for correlating requests on your end. This is the primary endpoint for building order-tracking workflows or monitoring shipment progress.
Address and Location Validation
The validate_address endpoint takes a postal_code and an optional country_code (ISO format, e.g. US, CA, GB) and confirms whether the combination is recognized by FedEx. The find_locations endpoint uses the same inputs to return nearby FedEx service points — useful for building store-locator features or letting users select a pickup location at checkout.
Country and Territory Coverage
The get_countries endpoint requires no inputs and returns a full array of every country and territory FedEx supports. Each entry includes countryCode, countryName, regionCode, currencyCode, and flags for capabilities such as domestic shipping availability and postal awareness. This is useful for populating shipping-destination dropdowns or programmatically filtering by region or currency before presenting shipping options to a user.
- Display real-time shipment status and delivery estimates in an e-commerce order tracking page using
track_by_tracking_number - Validate customer-entered postal codes against FedEx's accepted address data before checkout submission
- Build a store locator that surfaces nearby FedEx drop-off points from
find_locationsbased on a user's ZIP code - Populate a shipping destination dropdown with only the countries where FedEx supports domestic delivery using
get_countries - Filter available shipping destinations by
regionCodeorcurrencyCodeto restrict checkout to specific geographic zones - Automate shipment monitoring by polling
track_by_tracking_numberand alerting when event history updates - Cross-reference
postal_codeinput against FedEx's postal-aware countries before calculating shipping rates in a third-party system
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FedEx have an official developer API?+
What does the `track_by_tracking_number` endpoint return beyond the current status?+
output object that includes shipment status, estimated delivery date, and a full event history showing each scan or update along the shipment's journey. The transactionId field in the response can be used to match the response to your originating request.What country data does `get_countries` include for each entry?+
countryCode, countryName, regionCode, and currencyCode, plus boolean-style flags for domestic shipping support and postal code awareness. It does not currently include per-country rate tables or service-level availability. You can fork this API on Parse and revise it to add an endpoint that retrieves rate or service data for a specific country.Does the API support tracking shipments from other carriers (UPS, USPS, DHL)?+
track_by_tracking_number endpoint only resolves FedEx tracking numbers. You can fork this API on Parse and revise it to point at additional carrier sources if multi-carrier tracking is needed.