Get HSN Details

With this API, you can pass the HSN/SAC code and get information for goods and services.

GET /gst/compliance/e-way-bill/tax-payer/hsn

Get HSN Details

cURL

curl --request GET \
  --url https://api.sandbox.co.in/gst/compliance/e-way-bill/tax-payer/hsn \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'

200

200 HSN details fetched

{
  "code": 200,
  "data": {
    "data": {
      "hsnCode": "1001",
      "hsnDesc": "WHEAT AND MESLIN - Durum wheat :"
    }
  },
  "timestamp": 1763446641000,
  "transaction_id": "80a2b38f-7b5f-415e-afc1-8795d7049a68"
}

Response schema

For successful responses, this reference describes the NIC E-Way Bill payload at data.data.

View JSON schema

Headers

authorization · string · required

E-Way Bill access token. For token-generation steps, refer to the Generate E-Way Bill Session recipe, then pass the token in the authorization header.

x-api-key · string · required

API key for identification

x-api-version · string · default: 1.0.0

API version

Query Parameters

hsn_code · string · required

HSN/SAC code

Example:

"997212"

Response

200 - application/json

200 HSN details fetched / 216 Invalid HSN Code

Option 1

Option 2

An E-Way Bill success or NIC business-failure response. Both variants use HTTP 200.

code · enum<integer> · required

NIC response code.

Available options: 200

timestamp · integer<int64> · required

Unix timestamp.

transaction_id · string · required

Request transaction identifier.

data · object · required

Show child attributes