These docs are for v2023.01. Click to read the latest docs for v2024.09.

Calculate Tax and Duty

post

https://api.easyship.com/2023-01/taxes_and_duties

Retrieve tax and duty costs information.

Required authorization scope: Tax and Duty

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Rate limit

This endpoint is rate-limited by 5 requests per second, 20 requests per minute, 50 requests per hour, 100 requests per day, and 3,000 requests per month.

Exceeding this limit returns 429 Too Many Requests response for subsequent requests. If you need a higher rate limit, get in touch with us.

👍
Discover more about this API method in our How to Calculate Taxes and Duties guide.

Body Params

Tax and duty calculation request with Country IDs (based on Countries API)

destination_country_id

integer

enum

required

Country ID based on Countries API

origin_country_id

integer

enum

required

Country ID based on Countries API

insurance_fee

number

required

Insurance fee of a shipment

shipment_charge

number

required

Delivery fee of a shipment

currency

string

enum

ISO-4217 three-letter alphabetic currency code (e.g. USD, EUR, GBP). If not provided, the default currency will be based on origin_country_id.

items

array of objects

required

length ≥ 1

Every element represents a collection of items grouped by HS code

items*

duty_origin_country_id

integer

enum

required

Country of origin for the item. This field is used to calculate import tariffs. Country ID can be found in our Country API.

hs_code

string

required

^\d{8}$

Eight-digit WTO HS code with last two digits as 00 (e.g. 42029100).

customs_value

number

required

Total value of this HS code group

Responses

Language

Credentials

Bearer

token

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Rate limit

200get tax and duty

402when insufficient subscription tier for specific feature

422could not calculate tax and duty