🇪🇺  EU VAT is changing July 1, 2021, is my business ready? Learn more

Developers - build or customize a
successful international experience

Find out which of Zonos’ API, plugin, or integration will work best for your project. View the API guides below for flow charts, sample use cases, and other helpful info to get you started.

Example request
  • {
    • "amount" : 75.00,
    • "country_of_origin": "FR",
    • "description_retail": "Running shoe",
    • },
    • "hs_code": "6116.10.00",
    • "quantity": 1,
  • }
    • "Ship_from_country": 1,
    • "Ship_to": {
  • Duties $7.32

  • Import fees $2.19

  • Taxes $15.25

  • Shipping $9.25

  • Total $34.01

Zonos API guides

Learn about Zonos’ core cross-border product APIs

Landed Cost API

Landed Cost
API

Close window

Landed Cost API Landed Cost API

The Landed Cost API provides a complete breakdown of duties, taxes, and fees for each order request. This API is great if you are wanting a full, accurate landed cost with all line item details. You can display a sum of duties, fees, and taxes in your checkout or show even more detail if preferred.

Ideal for: Any project needing a complete landed cost including duty, taxes, and fees.

Read the doc

API endpoint

Request a Landed Cost

POST https://api.zonos.com/v1/landed_cost

Send item information to create a request for landed cost

Read the doc

API response

Landed Cost object

Returns a total landed cost breakdown including import duties, taxes, and fees.

Read the doc
Landed Cost Object
  • {
    • "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
    • "amount_subtotal": {
      • "duties": 10.17,
      • "fees": 21,
      • "taxes": 29.11
    • },
    • "currency": {
      • "id": "curr_1EEzH12eZvKYlo2CZXk7Lk2q",
      • "base": "USD",
      • "date": "2019-03-13T20:42:40.999+0000",
      • "rates": [
        • {
          • "currency": "EUR",
          • "rate": 0.8926
        • }
        ]
    • },
    • "customs": {
      • "amount_shipping": 25.00,
      • "delivery_duty_paid": "unknown",
      • "items": [
        • {

Better experience when accompanied by

Classify API

Classify API

Shipment Rating API

Rating API

Labels API

Labels API

Currenty API

Currency API

Localization API (legacy)

Localization
API

Order Complete API

Order Complete
API

How do I get started?

Get your API key here
Get your API key here

Contact Sales for pricing or to sign up and receive your API key to get started.

Click here
I need more info
I need more info

Contact Sales for answers to all of your questions.

Click here
Already a customer, contact support
Already a customer?

Need help getting setup? Contact the pros in customer success.

Click here
Classify API

Classify
API

Close window

Classify API Classify API

The Classify API provides an HS6-HS10 harmonized tariff code for each product submitted, allowing you to dynamically harmonize your catalog. This API can be used prior to or during the checkout process.

Ideal for: Anyone with a large catalog of products that is changing regularly. The Classify API allows you to constantly retrieve and update your system with accurate HS codes.

Read the doc

API endpoints

Request a classification

POST https://api.zonos.com/v1/classify

Create a request for an item classification to the sixth or eighth digit.

Read the doc

Retrieve a classification COMING SOON

GET https://api.zonos.com/v1/classify/:id

Retrieves a historical quote for an already classified item.

Read the doc

Retrieve a previous classification list COMING SOON

GET https://api.zonos.com/v1/classify

Retrieves a list of previous classifications.

API response

Classify Object

Returns the subheading country-specific HS code result in the codes array with the chapter and heading information.

Read the doc
Classify Object
  • {
    • "id": "clfy_8C49fk2945jmm232CcQtHtXdu",
    • "classified_code": "6116.10.0500",
    • "codes": {
      • "code": 61,
      • "description": ARTICLES OF APPAREL AND CLOTHING ACCESSORIES, KNITTED OR CROCHETED,
      • "type": chapter
    • },
    • {
      • "code": 6116,
      • "description": Gloves, mittens and mitts, knitted or crocheted,
      • "type": heading
    • },
      • "code": 6116.10,
      • "description": Gloves, mittens and mitts, knitted or crocheted,
      • "type": subheading

Better experience when accompanied by

Landed Cost API

Landed Cost API

International Checkout API

International Checkout API

Similar APIs

Shipment Rating API

Classify Assistant

Chapters API

Chapters API

How do I get started?

Classify API
Get your API key here

Contact Sales for pricing or to sign up and receive your API key to get started.

Click here
Classify API
I need more info

Contact Sales for answers to all of your questions.

Click here
Classify API
Already a customer?

Need help getting setup? Contact the pros in customer success.

Click here
International Checkout API

International Checkout API

Close window

International Checkout API International Checkout API

The Zonos™ International Checkout API gives your ecommerce shop a beautiful, international shopping experience. In addition to a complete landed cost, International Checkout also allows the shopper to shop in their local currency and language, includes fraud coverage, custom restrictions, denied party screening, localization, international promo codes, global payments and more.

Ideal for: Merchants who want a checkout that is optimized for an international shopping experience, but don't want the hassle of transforming their domestic checkout manually. Zonos International Checkout can be used with any eCommerce platform, custom cart or application. (plugins also available for the most popular shopping cart platforms)

Our service-oriented architecture includes the following REST APIs for integrating our Zonos International Checkout.

Read the doc

API endpoints

Create a checkout

Sends cart information and items from the customer’s cart.

To use our International Checkout with your platform, all you need to do is create a cart on your site and then post the items to the International Checkout API and Zonos does the rest.

Read the doc

Retrieve an order

Gets data for a completed order.

If you would like to pull your international orders into your platform, you can use the second endpoint, "Retrieve an order", which is recommended, but not required. Alternatively, if you have limited development resources, a hard-to-modify platform, or if you don't get many international orders, you may not want to use the "Retrieve an order" endpoint, and retrieve your orders manually. Orders are created in the Zonos system, when your customer completes checkout. You can manage all orders placed through Zonos International Checkout in the Zonos Dashboard.

Read the doc

Update an order

Updates various information on completed orders.

Changing or updating orders via the API is also not required, even if you create carts and retrieve orders via the Zonos International Checkout APIs.

Read the doc
Update Object
  • {
    • "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
    • "amount_subtotal": {
      • "duties": 10.17,
      • "fees": 21,
      • "taxes": 29.11
    • },
    • "currency": {
      • "id": "curr_1EEzH12eZvKYlo2CZXk7Lk2q",
      • "base": "USD",
      • "date": "2019-03-13T20:42:40.999+0000",
      • "rates": [
        • {
          • "currency": "EUR",
          • "rate": 0.8926
        • }
        ]
    • },
    • "customs": {
      • "amount_shipping": 25.00,
      • "delivery_duty_paid": "unknown",
      • "items": [
        • {

API flowchart examples and use cases

Better experience when accompanied by

Classify API

Classify API

Currenty API

Currency API

Labels API

Labels API

How do I get started?

Get your API key here
Get your API key here

Contact Sales for pricing or to sign up and receive your API key to get started.

Click here
I need more info
I need more info

Contact Sales for answers to all of your questions.

Click here
Already a customer, contact support
Already a customer?

Need help getting setup? Contact the pros in customer success.

Click here

Helper APIs

Zonos’ helper APIs are designed for international commerce and can be used alone to achieve a specific cross-border functionality or as add-ons to one of our core products.

Localization API

Localization API

Close window

Localization API Localization API Legacy

The Localization API will provide you with country-specific address fields with labels, as well as field - show/ hide, and field - require flags for each country so you can format your checkout or application's address fields correctly for international addresses.

Ideal for: This API is helpful if your current platform or application does not have correct international address fields, or does not match up with the fields that Zonos uses.

For example, the Canary Islands do not use the city field; they only have an island. For the Canary Islands, you would hide the city field and rename the state field to "Island".

Important note: This API is considered "Legacy" because the currency and exchange rate portion is deprecated. Only use the address localization portion of this API. You will want to use the new Currency API for currency and exchange rate information.

Read the doc

API endpoints

Localization

GET: https://test-api.iglobalstores.com/2.0/localization

Message format is JSON. There are no request parameters for this endpoint.

Read the doc

API response

Actual responses will contain all supported countries.

Read the doc
Localization response
  • {
    • "countries": {}
      • "CA": {
        • "name": Canada,
        • "code": CA,
        • "currency": CAD
      • },
      • "AU": {
        • "name": Australia,
        • "code": AU,
        • "currency": AUD
      • }
    • },
    • "exchangeRates": {
      • "CAD": {
        • "rateEstimate": "1.0312",
        • "rateGuaranteed": "null",
        • "rateGuaranteedId": "null",
      • },
      • "AUD": {
        • "rateEstimate": "1.1201",
        • "rateGuaranteed": "null",
        • "rateGuaranteedId": "null",
      • }
    • },
    • "addressFields": {
        • "CA":{
          • "countryCode": CA,
          • "nameLabel": First & Last Name,
          • "address1Label": Street Address,
          • "address2Label": "",
          • "address3Label": "",
          • "cityLabel": City,
          • "stateLabel": Province,
          • "zipLabel": Postal Code,
      • }
      ]
  • },

API flowchart examples and use cases

Better experience when accompanied by

Shipment Rating API

Rating API

Landed Cost API

Landed Cost API

How do I get started?

Localization API
Get your API key here

Contact Sales for pricing or to sign up and receive your API key to get started.

Click here
Localization API
I need more info

Contact Sales for answers to all of your questions.

Click here
Localization API
Already a customer?

Need help getting setup? Contact the pros in customer success.

Click here
Rating API

Rating API

Close window

Rating API Rating API

The Rating API will provide accurate shipping quotes from YOUR carrier's rates, based on package weight, dimensions, shipFrom and shipTo locations. The Rating API will use rates provided by your carrier's API, through connections that are configured in the Zonos Dashboard. If an API connection is not available for your carrier or particular service level, you can also set up rate sheets.

Ideal for: Anyone needing an easy way to surface shipping rates from one or more shipping carriers.

Read the doc

API endpoint

Request a shipment rating

POST https://api.zonos.com/v1/shipment_rating

Create a request for shipment rating by providing order and package-level information.

Read the doc

API response

Rating object

Returns shipping quotes by service level with a breakdown of surcharges, fees, and negotiated rate discounts that make up the quote.

Read the doc
Rating Object
  • {
    • "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
    • "currency": {
      • "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
      • "base": "USD",
      • "date": "2020-02-04T18:47:04.629+0000",
      • "rates": []
    • },
    • "quotes": [
      • {
        • "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
        • "amount_subtotal": 943.18,
        • "weight": {
          • "billable": 32.0,
          • "unit": "pound"
        • },
        ]
      • "mode": {
        • "service_level": "UPS_WORLDWIDE_EXPEDITED",
        • "display_name": "UPS Expedited"
        • "delivery_date_estimate": null
        • "transit_business_days": null
        • "transit_days": null
        • "rates": [
      • ]
  • }
  • Better experience when accompanied by

    Currenty API

    Currency API

    Labels API

    Labels API

    Localization API (legacy)

    Localization
    API

    Landed Cost API

    Landed Cost API

    How do I get started?

    Rating API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Rating API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Rating API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Customs API

    Customs API

    Close window

    Customs API Customs API COMING SOON

    The Customs API will generate any applicable customs documents and the data to correctly fill out customs documentation, such as a commercial invoice, certification of origin, or any country-specific statements required on the commercial invoice. The API will include a link to each document to be printed and included with the shipment or to be attached electronically to the label, if available.

    Ideal for: The Customs API is best used if you want to ensure you are generating the correct, required customs documents into each country. The Labels API will call the customs API so you can utilize the functionality of both when you are integrated with the Labels API.

    Read the doc

    API request

    Request customs documents COMING SOON

    Create a request for customs documentation.

    Read the doc

    API response

    Customs object COMING SOON

    Returns the information needed to properly complete a commercial invoice and customs documents.

    Read the doc
    Customs Object
    • {
      • {
      • "id": "cstm_1Ce6vt2eZvKYlo2CrgzPqxaz",
      • "attachments": [
        • {
          • "file": "https://cdn.zonos.com/ci/",
          • "type": "commercial_invoice",
        • }
      • ],
      • "currency": {
        • "id": "curr_1EEzH12eZvKYlo2CZXk7Lk2q",
        • "base": "USD",
        • "date": "2019-03-13T20:42:40.999+0000",
        • "rates": [
          • {
            • "currency": "EUR",
            • "rate": 0.8926
          • }
      • "items": {
        • "id": "294395",
        • "amount": 75.00,
        • "country_of_origin": "CN",
        • "country_of_origin_source": "platform",
        • "description_cutoms": "Men's t-shirt 100% cotton",
        • "description_retail": "Mars Attacks Men's Tee Black",
        • "detail": null,
        • ]

    API flowchart examples and use cases

    Better experience when accompanied by

    Labels API

    Labels API

    Shipment Rating API

    Rating API

    Currenty API

    Currency API

    Landed Cost API

    Landed Cost API

    Classify API

    Classify API

    How do I get started?

    Customs API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Customs API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Customs API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Labels API

    Labels API

    Close window

    Labels API Labels API COMING SOON

    The Labels API will allow you to create a shipping label or label quote for your international package/order, or for a batch of orders, by providing a link to the generated label. It will also call the Customs API and provide any needed customs documentation if you do not include them in your request. Customs documentation will be digitally attached to the label when created.

    Ideal for: This API works best if you are needing to generate an international label that meets each country's international requirements and to have the customs documents attached electronically, when applicable.

    API endpoint

    Request a Label COMING SOON

    POST https://api.zonos.com/v1/shipment_label

    Create a shipment label and label attachments.

    Cancel a label COMING SOON

    POST https://api.zonos.com/v1/shipment_label/:id/void

    Cancel a previously created shipment label.

    Retrieve a previous list of labels COMING SOON

    GET https://api.zonos.com/v1/shipment_label

    Retrieve a list of recent shipment label quotes.

    Retrieve a label COMING SOON

    GET https://api.zonos.com/v1/shipment_label/:id

    Look up any shipment label by quote ID.

    Retrieve open batch labels COMING SOON

    GET https://api.zonos.com/v1/shipment_label/batch

    Get a list of open batch shipment labels.

    Retrieve a batch label COMING SOON

    GET https://api.zonos.com/v1/shipment_label/batch/:id

    Lookup a single existing batch shipment label.

    Request a batch label with attachments COMING SOON

    POST https://api.zonos.com/v1/shipment_label/batch/:id/complete

    Complete a batch shipment.

    API response

    Labels object COMING SOON

    Returns a shipment label quote that contains the service level and price with an indication of whether the label was generated successfully.

    When you request the label with attachments, you will be provided with a PDF of the generated label.

    Labels Object
      • {
      • "id": "labl_1Rp9lhXSRXvEWVs97k2PHE",
      • "quotes": [
        • {
          • "id": "lbqt_75b246062b2c33259cd8",
          • "batch_id": null,
          • "error": null,
          • "name": "UPS Standard",
          • "amount": 34.19,
          • "carrier_service_level": "ups_standard",
          • "success": true,
        • }
      • {
        • "id": null,
        • "batch_id": null,
        • "error": "Failure - The selected service is not available from the origin to the destination.",
        • "name": "Domestic Ground",
        • "amount": null,
        • "carrier_service_level": "ups_ground",
        • "success": false,
      • }

    API flowchart examples and use cases

    Better experience when accompanied by

    Shipment Rating API

    Rating API

    Currenty API

    Currency API

    Customs API

    Customs API

    How do I get started?

    Get your API key here
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    I need more info
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Already a customer, contact support
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Chapters API

    Chapters API

    Close window

    Chapters API Chapters API

    The Chapters API will provide HS codes and the subchapters of the harmonized tariff schedule, based on which HS chapter you send in your request. This includes the two-digit, four-digit, and six-digit codes with the HS description so you can harmonize your product catalog. An eight-digit, country specific subchapter will be returned if the request includes a six-digit code and the country code. This API works best if you know which chapters or subchapters your products fall within.

    Ideal for: A more advanced user needing HS chapter and subchapter information including descriptions. This API can also be used to create a lookup tool for users to drill down into chapters and subchapters from an interface, to identify the correct HS code for a specific product.

    Read the doc

    API endpoint

    Request a chapter list

    POST https://api.zonos.com/v1/chapters

    Create a request for a complete or partial list of chapters and subchapters from the Harmonized Tariff Schedule.

    Read the doc

    API response

    Chapter object

    Returns the full or partial list of chapters and subchapters for HS codes with descriptions.

    Read the doc
    Chapter Object
    • {
      • "code": "61",
      • "subchapters": [
      • {
        • "code": "6116.10",
        • "description": "Gloves, mittens and mitts; knitted or crocheted, impregnated, coated or covered with plastics or rubber)",
        • "type": "subheading"
      • },
      • {
        • "code": "6116.91",
        • "description": "Gloves, mittens and mitts; of wool or fine animal hair, knitted or crocheted, (other than impregnated, coated or covered with plastics or rubber)",
        • "type": "subheading"
      • },
      ]
    • }

    API flowchart examples and use cases

    Better experience when accompanied by

    Landed Cost API

    Landed Cost API

    International Checkout API

    International Checkout API

    Customs API

    Customs API

    Labels API

    Labels API

    How do I get started?

    Chapters API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Chapters API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Chapters API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Classify Assistant API

    Classify Assistant

    Close window

    Classify Assistant API Classify Assistant

    The Classify Assistant API will return HS codes for common ecommerce product categories. Each product category will provide a category id that can be passed in the Landed Cost API to get the duty rate for your items.

    Ideal for: Users that are not very familiar with the harmonized tariff schedule and would like to drill down to find an appropriate HS code for a specific category or item. This API also works well for building an interface to allow basic users or customers to classify products.

    Read the doc

    API endpoint

    Retrieve a category list

    GET https://api.zonos.com/v1/categories

    Retrieves the full list of consumer category names and associated identifiers.

    Read the doc

    API response

    Category object

    Returns the full list of simplified consumer categories and the description for each category.

    Read the doc
    Category Object
    • {
      • "categories": [
      • {
        • "id": "catg_1",
        • "name": "Accessories, clothes, cosmetics",
        • "categories": [
          • {
            • "id": "catg_10",
            • "name": "Clothes and footwear",
            • "categories": []
          • },
          • {
            • "id": "catg_11",
            • "name": "Scarves, socks and tights",
            • "categories": []
              • {
                • "id": "catg_44",
                • "name": "Shawls, scarves",
                • "categories": []
              • },
          • },
      • }
      ]
    • }

    API flowchart examples and use cases

    Better experience when accompanied by

    Landed Cost API

    Landed Cost API

    International Checkout API

    International Checkout API

    Customs API

    Customs API

    Labels API

    Labels API

    How do I get started?

    Classify Assistant API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Classify Assistant API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Classify Assistant API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Currency API

    Currency API

    Close window

    Currency API Currency API

    The Currency API will return the current foreign exchange rate for a specific currency or country. The currency object can also be found within the Landed Cost Object.

    Ideal for: Displaying prices on your website or checkout in your shoppers local currency. You can also use this API to convert prices in order confirmation emails for your customers.

    Read the doc

    API endpoint

    Retrieve a currency list

    GET https://api.zonos.com/v1/currency

    Get an up-to-date list of foreign exchange rates by currency and country.

    Read the doc

    API response

    Currency object

    Returns a list of exchange rates by currency.

    Read the doc
    Currency Object
    • {
      • "id": "curr_1EEzH12eZvKYlo2CZXk7Lk2q",
      • "base": "USD",
      • "date": "2019-03-13T20:42:40.999+0000",
      • "rates": {
        • "country": "CA",
        • "currency": "CAD",
        • "rate": 1.4062
      • },
      • {
        • "country": "GB",
        • "currency": "GBP",
        • "rate": 0.8044
      • }
      ]
    • }

    Better experience when accompanied by

    Landed Cost API

    Landed Cost API

    International Checkout API

    International Checkout API

    Shipment Rating API

    Rating API

    Customs API

    Customs API

    Localization API (legacy)

    Localization
    API

    How do I get started?

    Currency API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Currency API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Currency API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here
    Order Complete API

    Order
    Complete API

    Close window

    Order Complete API Order Complete API

    The Order Complete API allows you to send Zonos the details of a completed order and get the Zonos order ID back.

    Ideal for: Anyone using the International Checkout API, Zonos labels, Landed Cost Guarantee, or if you are using the Landed Cost API and would like Zonos to provide reporting on your orders or need to to update Zonos with your orders for billing purposes.

    Read the doc

    API endpoint

    Request an Order Complete

    POST https://api.zonos.com/v1/orders

    Create a request for a completed order.

    Read the doc

    API response

    Order Complete object

    Returns the order details with the Zonos-specific order ID.

    Read the doc
    Order Complete Object
    • {
      • "id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
      • "date": "2019-11-04T20:42:40.999+0000",
      • "landed_cost_id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
      • "order_number": "123456",
      • }



    API flowchart examples and use cases

    For use with

    Landed Cost API

    Landed Cost API

    International Checkout API

    International Checkout API

    How do I get started?

    Order Complete API
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    Order Complete API
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Order Complete API
    Already a customer?

    Need help getting setup? Contact the pros in customer success.

    Click here

    Still not sure? Which Zonos Landed Cost
    option is best for me?

    • Use the Landed Cost API or one of our plugins to add a complete landed cost to your custom software or checkout.

      Landed Cost API

      API - The Landed Cost API will provide a complete breakdown of duties, taxes, and fees that make up a total landed cost.

      Zonos Landed Cost plugins and extensions

      Plugins - Integrate landed cost into your existing shopping cart using one of our plugins.

      * We have plugins for Shopify, BigCommerce, Magento, and Salesforce.

      Contact Sales for pricing

      or to sign up and receive your API key to get started.

      Click here
    • or

    • There are three ways to integrate International Checkout.

      International Checkout API

      API - Give your ecommerce shop a beautiful, international shopping experience by tying into the Zonos International Checkout experience.

      Zonos International Checkout plugins and extensions

      Plugins - Integrate International Checkout into your existing shopping cart using one of our plugins.

      * We have plugins for BigCommerce, Magento, XCART, and Miva.

      Zonos JS Integration for International Checkout

      Zonos JS - Connect International Checkout with a custom script if you do not have access to your backend code, or for a quick and simple solution.

      *Zonos JS orders are managed in Zonos Dashboard. To import orders into your system, you will need to tie into the Retrieve an Order API.

      Contact Sales for pricing

      or to sign up and receive your API key to get started.

      Click here

    What should I
    do for HS code classification?

    What are HS codes?

    Zonos products work at their maximum accuracy level with HS codes, so we highly recommended using them. With Zonos Classify, you can easily get HS codes for your entire catalog.

    • Option 1

      I'll use Zonos Classify to create my own HS codes

      Zonos Classify API Zonos Classify API
      Zonos Classify
      Easily classify your catalog
      with 8 digit HS codes
    • or

    • Option 2

      I have my own
      HS codes

      [example]

      07031010

      Your own HS codes
      If you have 6-digit HS codes, we recommend using Classify to get 8-digit, country level HS codes.
    5 star review

    We’ve reached more countries.

    [Zonos] has been a fantastic partner that has given us the ability to reach more countries and control our own destiny in regards to service offerings and costs. We had other options out there, but they were all tied to a company that wanted to control our freight.

    G2 Reviews Aaron B. (G2 reviews)

    Comprehensive docs

    We make things so much easier for you with our awesome docs (you're welcome)

    At Zonos, we have a documentation-first mentality and strive to create guides and information that is easy for anyone to understand.

    Our docs also include a mountain of valuable information on cross-border commerce, including our country guides, de minimis tables, and more!

    Read the docs

    Dev resource center

    Check out our tips below to help you get going.

    Is Zonos a good fit for my project?

    Zonos is a good fit for my project if...

    • You are needing duties, taxes, customs fees, international shipping, or cross-border features.
    • You work with a merchant with an online store (we do not work with marketplaces, such as eBay or Amazon).
    • You are receiving questions about customs, duties, taxes, and fraud.
    • You work with a merchant doing international but may have a variety of issues, such as:
      • Abandoned packages
      • Rejected packages at customs
      • Spending a lot of time on each order
      • Concerns with global compliance
      • Fear of international complexities
      • They want to grow their international sales or open new markets

    How to pitch Zonos to stakeholders?

    Now that you know about Zonos. What are some of the steps and tools available to use to inform my stakeholders and organization?

    • Help them understand why landed cost is not just duty and tax.
      • Duty and tax is only part of the story and can leave your customer frustrated
      • Zonos delivers a true total landed cost calculation, including the sum of duties, taxes, and additional fees from customs, brokers, or the shipping carrier.This means that the customer get the full picture with no surprise costs later.
    • Take a look at the Zonos docs
      • Our docs are packed with information and are broken into 3 categories:
        • Zonos products
        • Integrations
        • Customers Support
        • Country guides
    • Offer another Zonos demo for the organization to understand how it works
    • Check out the Zonos reviews at G2 https://www.g2.com/products/zonos/reviews
    • Check with your Zonos representative for one page product pdfs for you to share
    • Zonos works with your current process and systems by offering products, plugins, and APIs to match exactly what your organization needs to succeed
    • 30 to 35% of cross-border buyers will abandon your site within 1 minute if they don’t see duty and tax calculations are available.
    • Zonos Hello let's your customers know that you can handle their order, increasing conversion.

    How do I get started with Zonos?

    Now that you’ve identified that you are a good fit for Zonos, here’s how to get started.

    Contact the Zonos Sales team to:

    • Set up a demo
    • Get pricing
    • Sign up and get your API key

    Tips for success for Zonos?

    For developers

    1. Be sure to work with your Zonos customer success rep work with you on getting your account set up properly. It doesn’t matter how well you implement the API or app, if you don’t have your settings fine-tuned or set up properly you may not get accurate results. Reach out to your assigned rep if you have issues or questions.
    2. When using the Landed Cost API, don’t forget to put the version and your service token in the header. A simple tip, but this one seems to get a lot of engineers.
    3. At times, Zonos API documentation will define a field to say that "Possible values are..." and give a sample of possible values that could be returned. Our product is always improving and on some fields we expect to get more detailed over time so we don’t use definitive descriptors. We instead use a subjunctive language with the use of the word "possible". We recommend not using any field with words like "possible" in them as static fields.
    4. If you get stuck or have a question, check out our docs. The Zonos Dashboard is where your account is set up and customized.

    What is the Zonos implementation process?

    Our implementation timeline can depend on the integration or plugin type you are using and the ecommerce platform that you are on.

    • The typical time for the Landed Cost app plugin is 1-2 days.
    • The typical time for International Checkout is 1-2 weeks.

    Depending on your experience level, the actual integration of the code should take 1 - 4 hours of developer time per API, notwithstanding your company’s proprietary deployment schedule or other factors that are particular to your setup. To run a successful checkout, you should plan on integrating with at least three (3) of Zonos’ APIs.

    For example, a basic International Checkout integration includes:

    • Create a Checkout API
    • Retrieve an Order API
    • Update an Order API

    The Landed cost API simply returns a quote for your cart by passing cart information to Zonos.

    A Customer Success (CS) rep is assigned to each account that will help guide you through the process. The CS rep will also follow their account while they are with Zonos to help with questions or success.

    Are HS codes required?

    Zonos products work at their maximum accuracy level with HS codes, so we highly recommended using them with our products. With Zonos Classify, you can easily get HS codes for your entire catalog. However, they are not required, particularly if your catalog contains very similar items. If the variety of your catalog is vast, then they are recommended.

    How do I get started?

    Check out our tips below to help you get going.

    Get your API Key here
    Get your API key here

    Contact Sales for pricing or to sign up and receive your API key to get started.

    Click here
    I need more info
    I need more info

    Contact Sales for answers to all of your questions.

    Click here
    Already a customer, contact support
    Already a customer?

    Need help getting setup? Contact Customer success and mention API key.

    Click here