List Notices

Get the taxpayer’s notice list

GET /gst/compliance/tax-payer/notices

List Notices

cURL

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

200

{
  "code": 200,
  "timestamp": 1763446641000,
  "transaction_id": "41bb8041-fb83-4654-8d75-85a19f329158",
  "data": {
    "status_cd": "1",
    "data": {
      "notices": [
        {
          "refId": "ZA2005190002553",
          "arn": "AD070418000025L",
          "moduleCd": "IETCS",
          "alertCd": "IETCS_NOTCE_NOTSCN",
          "dateOfIssue": "20/01/2024",
          "dateOfRespond": "12/02/2024"
        }
      ]
    }
  }
}

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.

x-api-key · string · required

API key for identification.

x-api-version · string · default: 1.0.0

Compliance API version.

Query Parameters

date · string

Optional notice date filter in DD/MM/YYYY format.

Response

200 - application/json

200 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