Calculate Tax and Duty

post

https://public-api.easyship.com/2024-09/taxes_and_duties

Retrieve tax and duty costs information.

Use either of the two schemas WITH COUNTRY IDS OR WITH COUNTRY ALPHA2 to provide country specific details.

Required authorization scope: public.tax_and_duty:read

Note: This endpoint requires an advanced scope. You can enable advanced scopes when creating or editing your API connection.

Calls to this endpoint count towards your API usage allowance. You can monitor your current usage in the Subscription section of your account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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

Eight-digit HS code with last two digits as 00 (e.g. 42029100), or a ten-digit regional HS code (e.g. 4202910010).

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

200get tax and duty

402when insufficient subscription tier for specific feature

422could not calculate tax and duty