Duty Intelligence · min plan: starter · standard (1u) · scope: read:tariffs · both

Tariff Intelligence

Returns verified tariff context and change events by HSN, chapter, origin, destination, and effective date. Missing verified data is reported as not_found_or_unverified rather than AI-generated rates.

GET /v1/tariffs/current

Required scope

read:tariffs

Weighted API units

1 per success

Minimum plan

starter

Rate-limit bucket

standard

AI credits

—

Parameters

Name	In	Type	Required	Description
hsn	query	string	yes	6 or 8 digit HSN.
origin	query	string	yes	ISO alpha-2 origin country.

Sample request

curl "https://getway.clearie.ai/v1/tariffs/current?hsn=85171300&origin=VN&destination=IN&cif_value=100000" -H "Authorization: Bearer $CLEARIE_API_KEY"

Sample response

{
  "status": "verified",
  "hsn": "85171300",
  "effective_rate_pct": 43.96,
  "source_references": [
    {
      "source_type": "hsn",
      "source_name": "Verified tariff schedule"
    }
  ]
}

Live response contract

Live calls require API-key authentication, read:tariffs scope, plan access, and available quota. Successful calls consume 1 weighted API units; failed responses release reservations. AI credits are waived when no chargeable AI output is delivered.

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"

hsn* string// e.g. "85171300"

effective_rate_pct* number// e.g. 43.96

source_references* array [

item object {

source_type* string// e.g. "hsn"

source_name* string// e.g. "Verified tariff schedule"

}

]

}

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