const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    reference: 'order-123',
    destination_country: 'US',
    destination_country_currency: 'USD',
    shipping_cost: 200,
    insurance_cost: 50,
    transport_mode: 'sea',
    codes: [
      {
        hs_code: '6109100040',
        origin_country: 'CN',
        declared_value: 1000,
        origin_country_currency: 'CNY',
        weight: 10,
        weight_unit: 'kg'
      },
      {
        hs_code: '6204620090',
        origin_country: 'BD',
        declared_value: 800,
        origin_country_currency: 'USD',
        weight: 5,
        weight_unit: 'kg'
      }
    ]
  })
};

fetch('https://api.traddal.com/v1/duties/calculate/multiple', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "request_id": "c6f398bb-1dad-40e8-a991-a22a180ad842",
  "reference": "order-123",
  "calculation_type": "US",
  "destination_country": "US",
  "transport_mode": "air",
  "shipping_terms": "FOB",
  "quantity": 1,
  "values": {
    "shipping_cost": 200,
    "insurance_cost": 50
  },
  "currencies": {
    "origin": "<string>",
    "destination": "<string>",
    "exchange_rate": 123,
    "exchange_rate_display": "<string>"
  },
  "exemptions": {
    "de_minimis_threshold": 123,
    "de_minimis_exempt": true
  },
  "results": [
    {
      "hs_code": "6207110000",
      "origin_country": "CN",
      "weight": 1,
      "weight_unit": "kg",
      "volume": 9,
      "volume_unit": "liter",
      "declared_value": 100,
      "origin_country_currency": "USD",
      "estimated_duties": {
        "normal_tariff": {
          "tariffs": [
            {
              "name": "<string>",
              "rate": "<string>",
              "amount": 123,
              "type": "<string>"
            }
          ],
          "total_duty": 123
        },
        "preferential_tariff": {
          "tariffs": [
            {}
          ],
          "total_duty": 123
        },
        "total_duty": 123
      },
      "fees": {
        "MPF": {
          "code": "<string>",
          "amount": 123
        },
        "Cotton Fee": {
          "code": "<string>",
          "amount": 123
        },
        "total_fees": 123
      },
      "additional_tariff_measures": [
        {
          "code": "FDA",
          "name": "FDA - May Be Regulated",
          "description": "<string>",
          "agency": "Food and Drug Administration (FDA)",
          "measure_type": "Health / Safety",
          "condition": "<string>"
        }
      ]
    }
  ]
}

Duty Calculation

Calculate Multiple Duties

Calculate customs duties for multiple HS codes in a single request.

Common Fields: Apply to all codes in the request:

destination_country: Where all goods are being imported to
shipping_cost: Total shipping cost distributed across all codes
transport_mode: Mode of transport for all items
weight and weight_unit: Optional default values if not specified per item

Individual Code Fields: Each code in the codes array must include:

hs_code: The HS/HTS harmonized system code
origin_country: 2-letter origin country code
declared_value: Value in origin currency
weight: Weight for this specific item (required for accurate fee calculation)
weight_unit: Weight unit for this item
origin_country_currency: Optional currency code

POST

duties

calculate

multiple

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    reference: 'order-123',
    destination_country: 'US',
    destination_country_currency: 'USD',
    shipping_cost: 200,
    insurance_cost: 50,
    transport_mode: 'sea',
    codes: [
      {
        hs_code: '6109100040',
        origin_country: 'CN',
        declared_value: 1000,
        origin_country_currency: 'CNY',
        weight: 10,
        weight_unit: 'kg'
      },
      {
        hs_code: '6204620090',
        origin_country: 'BD',
        declared_value: 800,
        origin_country_currency: 'USD',
        weight: 5,
        weight_unit: 'kg'
      }
    ]
  })
};

fetch('https://api.traddal.com/v1/duties/calculate/multiple', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "success": true,
  "request_id": "c6f398bb-1dad-40e8-a991-a22a180ad842",
  "reference": "order-123",
  "calculation_type": "US",
  "destination_country": "US",
  "transport_mode": "air",
  "shipping_terms": "FOB",
  "quantity": 1,
  "values": {
    "shipping_cost": 200,
    "insurance_cost": 50
  },
  "currencies": {
    "origin": "<string>",
    "destination": "<string>",
    "exchange_rate": 123,
    "exchange_rate_display": "<string>"
  },
  "exemptions": {
    "de_minimis_threshold": 123,
    "de_minimis_exempt": true
  },
  "results": [
    {
      "hs_code": "6207110000",
      "origin_country": "CN",
      "weight": 1,
      "weight_unit": "kg",
      "volume": 9,
      "volume_unit": "liter",
      "declared_value": 100,
      "origin_country_currency": "USD",
      "estimated_duties": {
        "normal_tariff": {
          "tariffs": [
            {
              "name": "<string>",
              "rate": "<string>",
              "amount": 123,
              "type": "<string>"
            }
          ],
          "total_duty": 123
        },
        "preferential_tariff": {
          "tariffs": [
            {}
          ],
          "total_duty": 123
        },
        "total_duty": 123
      },
      "fees": {
        "MPF": {
          "code": "<string>",
          "amount": 123
        },
        "Cotton Fee": {
          "code": "<string>",
          "amount": 123
        },
        "total_fees": 123
      },
      "additional_tariff_measures": [
        {
          "code": "FDA",
          "name": "FDA - May Be Regulated",
          "description": "<string>",
          "agency": "Food and Drug Administration (FDA)",
          "measure_type": "Health / Safety",
          "condition": "<string>"
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

destination_country

string

required

2-letter destination country code

Required string length: 2

Example:

"US"

codes

object[]

required

List of HS codes with their individual details

Minimum array length: 1

Show child attributes

reference

string

Reference identifier for the calculation batch

Example:

"order-123"

destination_country_currency

string

3-letter currency code for destination

Required string length: 3

Example:

"USD"

weight

number

Default weight for items without specific weight (optional, but if provided, weight_unit is required)

Required range: x >= 0

Example:

15

weight_unit

enum<string>

Default weight unit (required if weight is provided)

Available options:

kg,

lb

Example:

"kg"

volume

number

Default volume for items without specific volume (optional, for volume-based specific duties)

Required range: x >= 0

Example:

10

volume_unit

enum<string>

Default volume unit (required if volume is provided)

Available options:

liter,

ml,

hl,

gallon,

proof_liter

Example:

"liter"

quantity

number

default:1

Quantity applied to all codes

Required range: x >= 0

shipping_cost

number

Total shipping cost for all items

Required range: x >= 0

Example:

200

insurance_cost

number

Total insurance cost for all items

Required range: x >= 0

Example:

50

quantity_unit

string

Unit of quantity

Example:

"No."

transport_mode

enum<string>

default:sea

Mode of transport

Available options:

sea,

air,

road,

rail

shipping_terms

enum<string>

default:FOB

Shipping terms

Available options:

FOB,

CIF,

EXW,

DDP

entry_date

string<date>

Entry date for historical calculations

Response

200 - application/json

Successful batch calculation

success

boolean

Example:

true

request_id

string<uuid>

Example:

"c6f398bb-1dad-40e8-a991-a22a180ad842"

reference

string

Example:

"order-123"

calculation_type

string

Example:

"US"

destination_country

string

Example:

"US"

transport_mode

string

Example:

"air"

shipping_terms

string

Example:

"FOB"

quantity

number

Example:

1

values

object

Show child attributes

currencies

object

Show child attributes

exemptions

object

Show child attributes

results

object[]

Array of calculation results for each HS code

Successful calculation result

Option 1
Option 2

Show child attributes

Overview

API Information

Authentication

Duty Calculation

Tariff Stacking

Classification

Orders

Webhooks

Calculate Multiple Duties

Authorizations

Body

Response