Duty Intelligence · min plan: growth · medium (2u) · scope: write:duty · both

Duty Calculation

Calculates BCD, SWS, IGST, CESS, ADD, safeguard duty, TRQ, FTA reduction, taxable value, total duty, effective rate, and landed value from verified DB-backed rates or deterministic sandbox fixtures.

POST /v1/duty/calculate

Required scope

write:duty

API credits

2 per success

Minimum plan

growth

Rate-limit bucket

medium

Parameters

Name	In	Type	Required	Description
hsn	body	string	yes	6 or 8 digit HSN.
origin	body	string	yes	ISO alpha-2 origin country.
destination	body	string	—	Import country, India in v1.
cif_value	body	number	yes	CIF value in supplied currency.

Sample request

curl -X POST "https://getway.clearie.neximprove.com/v1/duty/calculate" -H "Authorization: Bearer $CLEARIE_API_KEY" -H "Content-Type: application/json" -d '{"hsn":"85171300","origin":"VN","destination":"IN","cif_value":100000,"currency":"INR"}'

Sample response

{
  "status": "verified",
  "total_duty": 29500,
  "effective_rate_pct": 29.5,
  "components": [
    {
      "component": "bcd",
      "rate_pct": 5,
      "amount": 5000
    }
  ]
}

Live response contract

Live calls require API-key authentication, write:duty scope, plan access, and available quota. Successful calls consume 2 API credits.

Sandbox sample response

Workspace try-it calls use isolated representative sandbox records. They are for integration validation, not production filing.

Error examples

401 invalid key · 403 missing scope or plan · 429 quota/rate limit · 404 no verified data where applicable.

Response schema

root object {

status* string// e.g. "verified"

total_duty* integer// e.g. 29500

effective_rate_pct* number// e.g. 29.5

components* array [

item object {

component* string// e.g. "bcd"

rate_pct* integer// e.g. 5

amount* integer// e.g. 5000

}

]

}

Try this API live in the workspace

The in-app try-it console runs against the isolated deterministic sandbox repository. It never reads live customer or reference records.

Open in workspace Create account