Master Data · min plan: developer · standard (1u) · scope: read:master · both

HSN Imports

Returns import-side HSN classifications, import policy, licensing notes, BCD and IGST reference rates, and provenance.

GET /v1/master/hsn/imports

Required scope

read:master

API credits

1 per success

Minimum plan

developer

Rate-limit bucket

standard

Parameters

Name	In	Type	Required	Description
code	query	string	—	Exact or prefix HSN code.
q	query	string	—	Description search.
page	query	integer	—	One-indexed page.
page_size	query	integer	—	Rows per page, from 1 to 200.

Sample request

curl "https://getway.clearie.neximprove.com/v1/master/hsn/imports?code=72" -H "Authorization: Bearer $CLEARIE_API_KEY"

Sample response

{
  "items": [
    {
      "code": "72131090",
      "description": "Bars and rods of iron or non-alloy steel",
      "uqc": "KGS",
      "policy": "Free",
      "basic_duty_pct": 7.5,
      "igst_pct": 18
    }
  ],
  "page": 1,
  "page_size": 25,
  "total": 1,
  "meta": {
    "weighted_units": 1
  }
}

Live response contract

Live calls require API-key authentication, read:master scope, plan access, and available quota. Successful calls consume 1 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 {

items* array [

item object {

code* string// e.g. "72131090"

description* string// e.g. "Bars and rods of iron or non-alloy steel"

uqc* string// e.g. "KGS"

policy* string// e.g. "Free"

basic_duty_pct* number// e.g. 7.5

igst_pct* integer// e.g. 18

}

]

page* integer// e.g. 1

page_size* integer// e.g. 25

total* integer// e.g. 1

meta* object {

weighted_units* integer// e.g. 1

}

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