Skip to content

View & Track Returns#

View and Track Return API fetches public information on return filing of a particular GSTIN. You need to provide the financial year (FY) along with the GSTIN to fetch the results (return filings) done during that FY.

Route

/basic/gstn/{flynn-version}/commonapi/{gstn-api-version}/returns?gstin={gstin}&fy={fy}&action={action}&type={returnType}

  • active ‘flynn-version’: v3.0
  • method: GET

URL Parameters#

Name Description Type
flynn-version version of the API
for example, v3.0		 string
gstn-api-version as per the version of the GST API Documentation
for example, v0.3		 string

Query Parameters#

Name Description Type Mandatory
gstin GSTIN of the taxpayer
_for example, 33GSPTN0791G1Z5__		 string Yes
fy Financial Year of filing date, to filter the results 

 format = YYYY-YY 
 min-value = 2017-18
string Yes
action Api action
for example, RETTRACK		 string Yes
type return-type
for example, ALL-RTRN		 string No

Headers#

All required headers to make an authenticated API call.

Response#

200#

Successful response will be the same payload as per the ‘GST API Documentation’ for the “View and Track Returns” API.

Example

{
  "status": "1",
  "data": {
    "EFiledlist": [
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "10-12-2021",
        "ret_prd": "112021",
        "rtntype": "GSTR1",
        "arn": "AA331121000230J",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "16-11-2021",
        "ret_prd": "082021",
        "rtntype": "GSTR1",
        "arn": "AA330821000490W",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "16-11-2021",
        "ret_prd": "102021",
        "rtntype": "GSTR1",
        "arn": "AA331021000235B",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "12-09-2021",
        "ret_prd": "072021",
        "rtntype": "GSTR1",
        "arn": "AA330721000209T",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "12-05-2021",
        "ret_prd": "102020",
        "rtntype": "GSTR1",
        "arn": "AA331020000208A",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "11-05-2021",
        "ret_prd": "062020",
        "rtntype": "GSTR1",
        "arn": "AA330620000212A",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "11-05-2021",
        "ret_prd": "072020",
        "rtntype": "GSTR1",
        "arn": "AA330720000217Y",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "02-05-2021",
        "ret_prd": "052020",
        "rtntype": "GSTR1",
        "arn": "AA330520000287V",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "02-05-2021",
        "ret_prd": "092020",
        "rtntype": "GSTR1",
        "arn": "AA330920000267P",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "02-05-2021",
        "ret_prd": "122020",
        "rtntype": "GSTR1",
        "arn": "AA3312200002664",
        "status": "Filed"
      },
      {
        "valid": true,
        "mof": "ONLINE",
        "dof": "01-04-2021",
        "ret_prd": "112020",
        "rtntype": "GSTR1",
        "arn": "AA331120000182E",
        "status": "Filed"
      }
    ]
  },
  "error": null,
  "info": null,
  "additionalInfo": null,
  "alert": null
}
Errors#

Invalid GSTIN Format

{
      "status": "0",
      "data": null,
      "error": {
        "message": "err-invalid-gstin-format",
        "type": "ClientRequest",
        "args": {
          "parameter-name": "gstin"
        }
      },
      "info": null,
      "additionalInfo": null,
      "alert": null
}

Invalid GSTN API Version

{
  "status": "0",
  "data": null,
  "error": {
    "message": "err-invalid-gst-returns-api-version",
    "type": "ClientRequest",
    "args": {
      "version": "v8.0"
    }
  },
  "info": null,
  "additionalInfo": null,
  "alert": null
}

GSTN Error

{
      "status": "0",
      "data": null,
      "error": {
        "message": "err-gstn-returned-error",
        "type": "Gstn",
        "args": {
          "gstn-err": {
            "status-code": "0",
            "error-code": "RET11402",
            "message": "Unauthorized User"
          }
        }
      },
      "info": null,
      "additionalInfo": null,
      "alert": null
}
Response Status Description
400 Invalid GSTIN format in the request
400 Invalid GSTN API Version
404 Invalid GSTIN
502 Error at GSTN end

Common Errors

check here for other common errors.