What we do
Tools
Industries
Department
How we workLet's talk →
Home/Easyship
Easyship

The Easyship API, and the Product Data Its Duty Quotes Depend On

A parcel to Germany is stuck at customs because its declared value came through as zero, and nobody touched the store connection after the day it was switched on. Easyship rates couriers, prints labels and estimates import taxes and duties, from its dashboard or from its REST API. The API matters when you want to decide what gets sent with each shipment, because the duty math is only as good as the item data behind it.

Where Easyship stops

It handles carriers and customs forms, while what happens around them (orders, accounting, support) is left to you.

Stuck on Easyship? Let's solve it →
Easyship API in brief

Token: in the Easyship dashboard, create an API connection, name it and connect. You get a production token starting prod_ and a sandbox token starting sand_, each sent as Authorization: Bearer <token>.

APIs & Webhooks Create API Connection Connect

Hosts and version: public-api.easyship.com for live calls and public-api-sandbox.easyship.com for testing, on the current 2024-09 version. Integrations still on v2023 or the legacy v1 have migration guides in the docs.

Limits: the rate-limit page lists 60 requests a minute and 10 a second, and 6 a minute in the sandbox. Go over and you get a 429 until the next window.

Four Easyship calls between a paid order and a tracked parcel

  1. 1

    Request rates with the customs fields filled

    Send each item with an 8-digit hs_code, a customs_value and duty_origin_country_alpha2, the country where it was made. Turn on calculate_tax_and_duties and every rate comes back with estimated_import_tax and estimated_import_duty, so the checkout price can include them.

    Watch for: incoterms: "DDP" only works with tax and duty calculation on. Under DDP you charge the buyer at checkout and pay the duties on their behalf.

  2. 2

    Create the shipment

    The token needs the public.shipment:write scope, plus public.label:write if you ask for the label in the same call. Store Easyship's shipment ID against your own order number as soon as it returns.

    Watch for: sandbox responses carry sample data and a short courier list, so judge real courier choice and prices on production.

  3. 3

    Buy the label, one at a time or in a batch

    Create Label is synchronous for a shipment that already exists. Create a Batch of Labels handles a morning's worth at once, and the batch.finished and batch.item.finished events tell you how it went.

  4. 4

    Register a webhook and verify it

    APIs & Webhooks Add new webhook

    Pick events such as shipment.label.created, shipment.label.failed and shipment.tracking.statuschanged, or create the webhook through the API. Each delivery carries an X-EASYSHIP-SIGNATURE header: a JSON web token you decode with the webhook secret, which starts webh_.

    Watch for: answer with a 2xx right away. Easyship retries up to 30 times, a minute apart, then marks the webhook inactive.

Border holds that start in the product catalog

Easyship calculates duties from the item data it's given. These are the fields that usually arrive wrong.

A declared value of zero or a placeholder

How you'll know: A parcel is held, or a duty estimate looks far too low for what's in the box.

Fix: Send customs_value from what the customer actually paid for those lines, not a default set once in the store connection.

No HS code, or one too vague for the item

How you'll know: Rates come back without a duty estimate, or the same code is reused across very different products.

Fix: Store an HS code per SKU in the catalog. Easyship's HS code list is in the dashboard and through its HS code endpoint, so each product can be looked up once and sent on every shipment.

Made-in country set to the warehouse country

How you'll know: Duty is quoted as if goods sewn abroad were made where they're shipped from.

Fix: duty_origin_country_alpha2 is where the item was made. origin_country_alpha2 is where the parcel leaves. Fill both, from separate fields.

A destination the duty math handles poorly

How you'll know: Quotes to a few countries keep differing from what the courier later bills.

Fix: Easyship says fixed-amount tariffs (Switzerland is its example) aren't supported, and countries that change import rules often can lag. Flag those destinations for a person to review before checkout promises duties paid.

An apparel brand shipping to more than 30 countries

Apparel brand · Shopify storefront, Easyship for rate shopping, customs and labels

Before

Someone checked the declared value and HS code on each international order before the customs form looked right, because the defaults Easyship pulled in didn't always match the catalog.

Orders that slipped through with the wrong value were sometimes held at customs, and nobody knew until the customer asked where the package was.

After

Customs values and HS codes now come straight from the product catalog on every international shipment, so the paperwork is right before the label prints.

Customers get real tracking as soon as the parcel moves, without anyone opening Easyship to check.

Easyship platform and API questions

What is Easyship?

A shipping platform you can run from a dashboard or call as an API. It compares rates across a large network of couriers, prints labels, and estimates import taxes and duties for international parcels. It connects to storefronts such as Shopify and WooCommerce.

How much does Easyship cost?

Easyship lists its plans and what each includes on its own pricing page, and those change. The developer docs don't say which plan the API needs, so confirm that with Easyship for your account before you build.

Does Easyship have an API?

Yes, a REST API now on version 2024-09. Your own integration uses a bearer token from the APIs & Webhooks page. Apps built for other Easyship users go through OAuth 2.0 with scopes such as public.rate:read and public.shipment:write.

How does Easyship compare to ShipStation?

Easyship builds duty and tax estimates into its rates and is aimed at cross-border sellers. ShipStation is stronger on order management and marketplace connections. The share of your parcels that cross a border is the fairest way to choose.

How does Easyship compare to Shippo?

Both are multi-carrier platforms with a dashboard and an API. Easyship leans on customs and duty handling. Shippo shows up as the shipping layer inside a wide range of ecommerce software. Either can sit under a custom integration; the customs fields described above matter on both.

Is Easyship good for a business selling internationally?

It's built for that job: duty estimates at checkout, DDP shipping and customs paperwork. The weak spot is the item data it receives. n-frames builds the link from your catalog to Easyship so every international shipment carries its HS code, value and made-in country, and label and tracking events flow back to the order and the help desk.

Can Easyship tell my system when tracking changes?

Yes, through webhooks. shipment.tracking.statuschanged and shipment.tracking.checkpointscreated cover tracking, alongside label, cancellation and batch events. Your endpoint has to verify the signature and reply with a 2xx.

Let's talk

Tell us the one thing your team does manually that eats up time. We read every message and reply within a day.