Incentives · min plan: growth · medium (3u) · scope: write:schemes · both

Drawback Eligibility

Evaluates verified drawback rows, exclusions, and filing rules to return eligible, conditionally eligible, or not verified decisions.

POST /v1/drawback/eligibility

Required scope

write:schemes

API credits

3 per success

Minimum plan

growth

Rate-limit bucket

medium

Parameters

Name	In	Type	Required	Description
hsn	body	string	yes	6 or 8 digit HSN.
product	body	string	—	Product description.

Sample request

curl -X POST "https://getway.clearie.neximprove.com/v1/drawback/eligibility" -H "Authorization: Bearer $CLEARIE_API_KEY" -H "Content-Type: application/json" -d '{"hsn":"62030101","product":"Men cotton trousers"}'

Sample response

{
  "status": "verified",
  "decision": "eligible",
  "reasons": [
    "Verified rate row exists for the supplied HSN/date."
  ]
}

Live response contract

Live calls require API-key authentication, write:schemes scope, plan access, and available quota. Successful calls consume 3 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"

decision* string// e.g. "eligible"

reasons* array [

item string// e.g. "Verified rate row exists for the supplied HSN/date."

]

}

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