UPSLegacy Web ServicesglobalXML over HTTPSunset

UPS Legacy XML/SOAP Web Services (sunset)

UPS's pre-2024 XML and SOAP web services. Sunset on 2024-06-03. Documented here so legacy integrators searching for 'UPS XML API' can land on the correct migration path rather than a 404.

Sunset surface — read before integrating.

UPS sunset its legacy XML and SOAP web services on 2024-06-03. Calls against the legacy endpoints fail; the only supported integration path is the modern REST/OAuth 2.0 Developer APIs.

Recommended replacement: UPS Developer APIs (REST + OAuth 2.0).

The UPS legacy XML/SOAP web services were sunset on 2024-06-03. They covered the same operations now served by the UPS Developer APIs (Shipping, Rating, Tracking, Address Validation, Time in Transit, Locator), but used XML payloads with credentials embedded directly in the request body and a per-service WSDL. Calls against the legacy endpoints no longer succeed. This page exists because integrators still encounter the legacy endpoints in long-lived codebases, vendor scripts, and ERP plug-ins. The replacement is the UPS Developer APIs surface, which uses REST with JSON and OAuth 2.0 client_credentials. The migration changes more than the transport: rate-response shapes, tracking-event vocabularies, and error codes all evolved during the move. Plan the migration as a contract change, not as an endpoint swap. If an existing integration still references the legacy endpoints, treat that as a sev-2 incident waiting to happen at the next batch run. Schedule a cutover with parallel running against the new REST endpoints, validate label formats and rate parity in the UPS Customer Integration Environment, and only retire the legacy code path after a full reconciliation cycle in production.

Surface details

API name
UPS Legacy XML/SOAP Web Services
Authentication
Access License Number plus username and password in the SOAP/XML request body

Frequently asked questions

Can I still call the UPS XML or SOAP endpoints?

No. UPS sunset the legacy XML/SOAP web services on 2024-06-03. The only supported integration path is the REST/OAuth 2.0 Developer APIs.

Is the migration a transport-only change?

No. Rate response shapes, tracking-event vocabularies, and error codes changed during the migration. Treat the move as a full contract migration with parallel running and explicit cutover, not as a base-URL swap.

Where do I get migration guidance from UPS?

The UPS Developer Portal hosts the official migration guidance and the OpenAPI references for the replacement REST APIs.

Related concepts

Sibling carrier surfaces

Tooling and references

  • UPS Developer Portal (REST + OAuth 2.0)

    Modern UPS REST surface for Shipping, Rating, Tracking, Address Validation, and Time in Transit. Replaces the legacy UPS XML/SOAP web services that were sunset on 2024-06-03.

Sources

Last reviewed: 2026-04-25