Skip to main content
GET
/
gst
/
compliance
/
tax-payer
/
e-invoices
/
hsn
/
{year}
/
{month}
Get E-Invoice HSN Summary
curl --request GET \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/e-invoices/hsn/{year}/{month} \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'
{
  "code": 200,
  "data": {
    "data": {
      "gstin": "01AABCE2207R1Z5",
      "fp": "052020",
      "hsn": {
        "hsn_b2b": [
          {
            "num": 1,
            "hsn_sc": "2101",
            "desc": "MISCELLANEOUS EDIBLE PREPARATIONS~Extracts, essences and concentrates, of coffee, tea or mate and preparations with a basis of these products or with a basis of coffee, tea or mate; roasted chicory and other roasted coffee substitutes, and extracts, essences and concentrates thereof",
            "user_desc": "Taxpayer Description",
            "uqc": "BDL",
            "qty": 12,
            "rt": 0.1,
            "txval": 1212,
            "iamt": 3342,
            "camt": 343,
            "samt": 24,
            "csamt": 423,
            "chksum": "fasdflkjwhrkfjshdfua"
          }
        ],
        "hsn_b2c": [
          {
            "num": 1,
            "hsn_sc": "1102",
            "desc": "CEREAL FLOURS OTHER THAN THAT OF WHEAT OR MESLIN",
            "user_desc": "Taxpayer Description",
            "uqc": "BDL",
            "qty": 10,
            "rt": 0.1,
            "txval": 4312,
            "iamt": 242,
            "camt": 643,
            "samt": 24,
            "csamt": 423,
            "chksum": "bnsfsfskfsifi"
          }
        ]
      }
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "5fc1acb2-1fd0-49e8-b6f3-19b60e67009d"
}

ā€‹
Response body schema

View response body schema

Headers

ā€‹
authorization
string
required

GST taxpayer access token.

ā€‹
x-api-version
string
default:1.0.0

API version.

ā€‹
x-api-key
string
required

API key for identification.

Path Parameters

ā€‹
year
string
required

Return period year.

Example:

"2024"

ā€‹
month
string
required

Return period month.

Example:

"05"

Response

200 - application/json

200 Success. The GST portal marks this source API as unencrypted, but the sandbox response is still wrapped in the standard code/data/timestamp/transaction_id envelope.

The response is of type object.