Key features
GraphQL flexibility: Query exactly the data you need with a single endpoint, reducing over-fetching and improving performance compared to traditional REST APIs.
Guaranteed calculations: UPS guarantees quoted landed costs when proper validation requirements are met during shipment creation, protecting both merchants and customers.
Comprehensive coverage: Support for 217+ destination countries with real-time duty, tax, and fee calculations based on current trade regulations.
Workflow-based design: Organized API calls into logical workflows that mirror real-world shipping processes for easier integration.
How it works
The API uses a workflow-based approach where you create parties (origin/destination), items, cartons, and shipping details, then calculate the landed cost in a single GraphQL mutation. When customers proceed to ship, the quote ID ensures validation against the original calculation - if shipment details match, UPS guarantees the costs and handles duty/tax payments directly.
Developer benefits
Single GraphQL endpoint with introspective schema documentation and strongly-typed queries reduce integration complexity.
Batch operations in a single request and query only the fields your application needs for optimal performance.
Built-in validation of addresses, HS codes, and shipment data ensures accurate calculations and maintains guarantees.
Flexible integration into existing e-commerce platforms, mobile applications, or enterprise order management systems.
Support
For API technical support or integration questions, email globalcheckoutsupport@ups.com.
When contacting support, include your UPS shipper number and detailed descriptions of any integration issues or API errors.
UPS Global Checkout API
Build custom landed cost integrations using our GraphQL API for accurate duty and tax calculations.
The UPS Global Checkout API provides developers with direct access to calculate landed costs for international shipments through a flexible GraphQL interface. Build custom integrations for e-commerce platforms, mobile apps, or enterprise systems with guaranteed duty and tax calculations across 217+ countries and territories.