FedExExpressusRESTActive

FedEx REST APIs (Express, US, OAuth 2.0)

Modern REST surface for FedEx Express in the US, exposed through developer.fedex.com. OAuth 2.0 client_credentials, JSON payloads, sibling to the legacy FedEx Web Services SOAP product.

The FedEx REST APIs at developer.fedex.com are the modern integration surface for FedEx Express in the US. They expose Ship, Rate, Track, Address Validation, and supporting operations as REST endpoints with JSON payloads, authenticated through OAuth 2.0 client_credentials. They are the default new-integration target and the API surface FedEx is investing in. The REST APIs run alongside the older FedEx Web Services SOAP product. Both still work today; FedEx has not announced a final SOAP sunset date as of this page's last review, but new contracts are typically issued on the REST surface and integrators should default to it. The two surfaces are not interchangeable: the REST APIs use JSON, OAuth tokens, and an updated error vocabulary, while the SOAP services use WSDL-driven envelopes and credentials embedded in the body. Operationally, the REST surface returns paginated results for tracking lookups, supports proactive notifications through FedEx's webhook product, and surfaces multi-piece shipment errors per piece rather than collapsing them into a single fault. Schema validation against the FedEx OpenAPI document before sending requests turns vague carrier errors into precise local failures and shortens incident loops. Sandbox returns deterministic test data; verify rate parity in production with a small parallel-running window before retiring any legacy code path.

Surface details

API name
FedEx REST APIs (developer.fedex.com)
Authentication
OAuth 2.0 client_credentials grant with bearer tokens
Production base URL
https://apis.fedex.com/
Sandbox base URL
https://apis-sandbox.fedex.com/
Sandbox notes
Sandbox uses a separate hostname and separate API keys. Tokens issued in sandbox are not valid in production. Some FedEx Ground operations require additional production credentials beyond the sandbox account.

Frequently asked questions

Should new FedEx integrations target REST or SOAP?

REST. The FedEx Developer Portal at developer.fedex.com is FedEx's investment surface and the default new-integration target. The legacy FedEx Web Services SOAP product still works but should not be the choice for greenfield work.

How do I authenticate the FedEx REST APIs?

OAuth 2.0 client_credentials. Post your API key and secret to the FedEx token endpoint, cache the bearer token centrally, and refresh proactively before expiry. Do not embed credentials in the request body.

Are FedEx Ground and FedEx Express on the same API?

They are accessed through the same FedEx REST surface, but the products have distinct operations, surcharges, and account requirements. Treat them as different shipping services that share an API base, not as identical interchangeable services.

Related concepts

Sibling carrier surfaces

Tooling and references

Sources

Last reviewed: 2026-04-25