Zonos logo
DOCS

Api reference

/

Zonos API introduction 

Welcome to the Zonos API reference documentation! 

The Zonos API is constructed around REST. The API offers resource-oriented URLs, returns JSON-encoded responses, accepts form-encoded request bodies, and uses standard HTTP response codes and authentication.

To access the Zonos API, you will need an API key. The same API key will be used for testing purposes and when the integration is live. The API key is used to authenticate the requests.

Periodically, we will add fields to our API. In order to prevent errors once you are integrated with our API, we recommend ignoring unknown fields. You can also view our API changelog for changes that have been made with each version of our APIs.

Authentication

Zonos uses API keys to allow access to the API. You can register for a new Zonos account and API key here.

The API key will be included in all API requests to the server in a header that looks like the following:

serviceToken: meowmeowmeow

Version

To access the API version, send the zonos-version header. Review the corresponding API documentation for the appropriate header information, if applicable and required.

The API changelog also lists every available version with the header information.

If no version is specified, the default will be set to the last supported version.

The current version header is zonos-version: 2021-01-01.

Getting started

  • Landed Cost API - Get a breakdown of duty, tax, and additional fees that make up a landed cost.
  • Basic Landed Cost API - Retrieve a landed cost without HS codes and other item details.
  • ClassifyAPI - Dynamically harmonize your catalog.