GSTR-1A HSN Summary

API call for getting HSN Summary details.

GET /gst/compliance/tax-payer/gstrs/gstr-1a/hsn/{year}/{month}

GSTR-1A HSN Summary

cURL

curl --request GET \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/gstr-1a/hsn/{year}/{month} \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'

200

success

{
  "code": 200,
  "timestamp": 1763446641000,
  "transaction_id": "41bb8041-fb83-4654-8d75-85a19f329158",
  "data": {
    "status_cd": "1",
    "data": {
      "hsn": {
        "flag": "N",
        "chksum": "ASDFGJKLPTBBJKBJKBBJKBB",
        "hsn_b2b": [
          {
            "num": 1,
            "hsn_sc": "1102",
            "desc": "CEREAL FLOURS OTHER THAN THAT OF WHEAT OR MESLIN",
            "user_desc": "WHEAT FLOUR",
            "uqc": "BOX",
            "qty": 2,
            "txval": 100,
            "camt": 0.5,
            "samt": 0.5,
            "rt": 1
          }
        ],
        "hsn_b2c": [
          {
            "num": 1,
            "hsn_sc": "1301",
            "desc": "LAC; NATURAL GUMS, RESINS",
            "user_desc": "RESINS",
            "uqc": "CTN",
            "qty": 2,
            "txval": 100,
            "iamt": 1,
            "csamt": 10,
            "rt": 1
          }
        ]
      }
    }
  }
}

Response body schema

View response body schema

Response schema

For successful responses, this reference describes the GSTN payload at data.data.

View Excel field reference

Headers

authorization · string · required

GST taxpayer access token. For token-generation steps, refer to the Generate Taxpayer Session flow and pass the token in the authorization header.

x-api-version · string · default: 1.0.0

Compliance API version.

x-api-key · string · required

API key for identification.

Path Parameters

year · string · required

Return year, for example 2025.

month · string · required

Return month, for example 04.

Response

200 - application/json

Success

Option 1

Option 2

A GSTN success or GSTN business-failure response. Both variants use HTTP 200.

code · enum<integer> · required

The HTTP status code reported in the response body.

Available options: 200

Example:

200

timestamp · integer<int64> · required

The response timestamp in Unix epoch milliseconds.

Example:

1763446641000

transaction_id · string · required

The transaction identifier used to trace the request.

Example:

"41bb8041-fb83-4654-8d75-85a19f329158"

data · object · required

The GSTN success wrapper.

Show child attributes