Skip to main content
GET
/
gst
/
compliance
/
tax-payer
/
gstrs
/
{year}
/
{month}
/
track
Track Returns
curl --request GET \
  --url https://api.sandbox.co.in/gst/compliance/tax-payer/gstrs/{year}/{month}/track \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>'
{
  "code": 200,
  "data": {
    "data": {
      "EFiledlist": [
        {
          "arn": "AA010143556585B",
          "ret_prd": "022017",
          "mof": "ONLINE",
          "dof": "08-02-2017",
          "rtntype": "GSTR2",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA010143556585B",
          "ret_prd": "022017",
          "mof": "ONLINE",
          "dof": "07-02-2017",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA010143556587A",
          "ret_prd": "032017",
          "mof": "ONLINE",
          "dof": "07-03-2017",
          "rtntype": "GSTR3",
          "status": "Filed",
          "valid": "N"
        }
      ]
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "0ca94d55-c0ab-452f-9d28-e0f9509d1df4"
}

ā€‹
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"

Query Parameters

ā€‹
return_type
string

Optional return type filter. Use repo-style values such as gstr-1, gstr-3b, or gstr-9.

Example:

"gstr-1"

Response

200 - application/json

200 Success. On GST-side business failure, the sandbox wrapper still returns 200 with data.status_cd = "0" and an error object.

The response is of type object.