HSN Goods Lookup API

Authenticated GET lookup and bounded search over the ManTech-curated catalog (dataset mantech-hsn-sac-catalog-2026.08). Not a complete CBIC schedule, not live tax law, and not an AI classifier. Host: https://mantechstudio.in/api/v1 with a console TEST key.

Discuss an API integration Use the HSN finder

Available in TEST·Live in TEST on https://mantechstudio.in/api/v1 using Developer Console keys (Authorization: Bearer mantech_test_…). /external/v1 is a different credential store.

Codes are strings (2 / 4 / 6 / 8 digits, not Chapter 99). Normalization: trim; spaces and hyphens removed; no number cast, padding, truncation, or fuzzy correction. Leading zeros matter. gstRate is published only for a source-verified snapshot record.

GET/api/v1/hsn/{code}

Invalid format → 400. Well-formed but absent → 404.

cURL

curl "https://mantechstudio.in/api/v1/hsn/2523" \
  -H "Authorization: Bearer mantech_test_0123456789abcdef.example_secret"

JavaScript fetch

const res = await fetch('https://mantechstudio.in/api/v1/hsn/' + encodeURIComponent('2523'), {
  headers: { Authorization: 'Bearer mantech_test_0123456789abcdef.example_secret' }
});
const data = await res.json();

Example 200 body

{
  "type": "hsn",
  "code": "2523",
  "description": "Portland cement, aluminous cement, slag cement, super sulphate cement and similar hydraulic cements",
  "chapter": "25",
  "heading": "2523",
  "gstRate": 18,
  "dataVersion": "mantech-hsn-sac-catalog-2026.08"
}

GET/api/v1/hsn/search

Query q is required (2–100 characters). Optional limit is capped at 20. Search is bounded token/substring matching, not AI or semantic ranking.

cURL

curl "https://mantechstudio.in/api/v1/hsn/search?q=cement" \
  -H "Authorization: Bearer mantech_test_0123456789abcdef.example_secret"

JavaScript fetch

const params = new URLSearchParams({ q: 'cement' });
const res = await fetch('https://mantechstudio.in/api/v1/hsn/search?' + params.toString(), {
  headers: { Authorization: 'Bearer mantech_test_0123456789abcdef.example_secret' }
});

Playground · Auth, errors, quota

Loading…

HSN Goods Lookup API

const res = await fetch('https://mantechstudio.in/api/v1/hsn/' + encodeURIComponent('2523'), { headers: { Authorization: 'Bearer mantech_test_0123456789abcdef.example_secret' } }); const data = await res.json();

{ "type": "hsn", "code": "2523", "description": "Portland cement, aluminous cement, slag cement, super sulphate cement and similar hydraulic cements", "chapter": "25", "heading": "2523", "gstRate": 18, "dataVersion": "mantech-hsn-sac-catalog-2026.08" }

const params = new URLSearchParams({ q: 'cement' }); const res = await fetch('https://mantechstudio.in/api/v1/hsn/search?' + params.toString(), { headers: { Authorization: 'Bearer mantech_test_0123456789abcdef.example_secret' } });