Classify product items and calculate duties using the Zonos Classify and Landed Cost GraphQL APIs

Steps

1. In the Zonos Dashboard, navigate to Settings > Integrations, create a GraphQL API key, and assign the Classify and Landed Cost roles to the key.
2. Send a GraphQL POST request to https://api.zonos.com/graphql with the header credentialToken: YOUR_TOKEN and Content-Type: application/json.
3. Call the classify mutation passing item name, description, material, and countryOfOrigin; Zonos returns an HS code with a confidence score — store both for audit purposes.
4. Pass the returned HS code, declared value, origin country, and destination country into the landedCost query to retrieve itemized duties, import taxes, and carrier fees.
5. Present the itemized landed cost breakdown at checkout; Zonos Guaranteed Landed Cost mode shifts duty liability to Zonos, while estimated mode keeps liability with the merchant.
6. Handle the 10,000 free classifications per year cap; beyond that limit, per-classification fees apply — cache classification results by item SKU to minimise API calls.