Track GST Returns

Check compliance for a GST-registered business by passing the financial year and the GSTIN. Further, you can filter the list by passing the return type.

POST /gst/compliance/public/gstrs/track

cURL

200 Filed returns

curl --request POST \
  --url https://api.sandbox.co.in/gst/compliance/public/gstrs/track \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "gstin": "33ABKCS2033B1ZW"
}
'

200

200 Filed returns

{
  "code": 200,
  "data": {
    "data": {
      "EFiledlist": [
        {
          "arn": "AA330820000343Z",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "082020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330920000445R",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "092020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3310200003682",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "102020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA331120000360G",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "112020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3312200004719",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "122020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330121000749R",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "012021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330321000450A",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "032021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330720000428R",
          "dof": "01-02-2023",
          "mof": "GSP",
          "ret_prd": "072020",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330621000547P",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "062021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3303220002437",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "032022",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3302220002629",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "022022",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3301220002283",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "012022",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3311210003448",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "112021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA331221000400G",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "122021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3310210003490",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "102021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330921000392S",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "092021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330821000569F",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "082021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330721000374U",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "072021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3305210003144",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "052021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA330421000474Y",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "042021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3302210003736",
          "dof": "30-01-2023",
          "mof": "GSP",
          "ret_prd": "022021",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        },
        {
          "arn": "AA3312220001761",
          "dof": "25-01-2023",
          "mof": "GSP",
          "ret_prd": "122022",
          "rtntype": "GSTR1",
          "status": "Filed",
          "valid": "Y"
        }
      ]
    },
    "status_cd": "1"
  },
  "timestamp": 1763446641000,
  "transaction_id": "7495493a-b127-4eca-a304-a550fbc98447"
}

Response schema

For successful responses, these resources describe the GSTN payload at data.data.

View response JSON schema

View Excel field reference

Headers

authorization · string · required

JWT access token

x-accept-cache · boolean

Pass true to accept the cached response. If the header is not passed, or if false is sent as the value, the request will hit the origin.

x-api-key · string · required

API key for identification

x-api-version · string · default: 1.0.0

API version

Query Parameters

gstr · string

Optional GST Return type to be passed as filter. E.g. gstr-1

Example:

"{{gstr}}"

financial_year · string · required

Financial Year of GST Returns e.g. FY 2021-22

Example:

"{{financial_year}}"

Body

application/json

gstin · string · required

GSTIN of the Taxpayer

Response

200

application/json

200 Filed returns / RTN_22 Select Valid FY / RET13510 No Record Found

code · number

Example:

200

data · object

Show child attributes

timestamp · number

Example:

1763446641000

transaction_id · string

Example:

"7495493a-b127-4eca-a304-a550fbc98447"