Calculate a guaranteed landed cost quote for an international order using the Zonos Landed Cost GraphQL API
domain: zonos.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Build the required GraphQL inputs: partyCreateWorkflowInput for shipping parties, and itemCreateWorkflowInput for each item's amount, currencyCode, quantity, countryOfOrigin, and a productId or sku.
Decide how to supply HS codes: pass a product-specific hsCode per item for the most accurate duty calculation, or omit it and let Zonos check its Catalog and then fall back to Classify (using description, category, and material) to auto-generate one.
Provide shipping cost either via shipmentRatingCreateWorkflowInput (you already know the service level and amount) or shipmentRatingCalculateWorkflowInput (have Zonos calculate it from your configured shipping profiles).
Set landedCostWorkFlowInput fields: calculationMethod (use DDP_PREFERRED for a guaranteed quote), endUse (FOR_RESALE vs NOT_FOR_RESALE), and tariffRate (use ZONOS_PREFERRED for a guaranteed quote).
Send the landedCostCalculateWorkflow GraphQL mutation and parse the returned duties, taxes, and fees breakdown, each with amount, currency, and note.
After receiving the landedCostId from the response, call the orderCreate mutation with that ID to finalize the order in Zonos if Zonos is also processing the transaction.
Known gotchas
Using calculationMethod DAP, or a tariffRate method other than ZONOS_PREFERRED, can disqualify the quote from Zonos' landed-cost guarantee, shifting the risk of calculation discrepancies back to you.
If you pass an invalid or nonexistent hsCode, Zonos re-classifies the item on the fly and silently substitutes its own code rather than returning an error, so a bad HS code won't necessarily surface as a failure — it will just change the duty basis used.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?