';

Taxpayer Return Status API Response

You are here:
Estimated Reading Time: Less than a minute

Taxpayer Return Status API Response

1. if provided GSTIN is valid then you will receive below kind of response:

Response

{
 "data": {
 "EFiledlist": [
 {
 "valid": "Y",
 "dof": "20-07-2018",
 "mof": "ONLINE",
 "ret_prd": "062018",
 "rtntype": "GSTR3B",
 "arn": "AA060618417884S",
 "status": "Filed"
 },
 {
 "valid": "Y",
 "dof": "10-07-2018",
 "mof": "ONLINE",
 "ret_prd": "062018",
 "rtntype": "GSTR1",
 "arn": "AA060618140261G",
 "status": "Filed"
 },
 {
 "dof": "16-06-2018",
 "mof": "ONLINE",
 "ret_prd": "052018",
 "rtntype": "GSTR3B",
 "arn": "AA060518194293X",
 "status": "Filed"
 },
 {
 "valid": "Y",
 "dof": "09-06-2018",
 "mof": "ONLINE",
 "ret_prd": "052018",
 "rtntype": "GSTR1",
 "arn": "AA060518106322K",
 "status": "Filed"
 }
 ]
 },
 "status_code": 1
}

2. if provided GSTIN is invalid then you will receive below kind of responses:

 

Response 1:

{
 "status_code": 0,
 "gstin": "35AAGFH3243L1Z",
 "error": "Invalid GSTIN/UIN number : 35AAGFH3243L1Z"
 }

 

Response 2:

{
 "error": {
 "message": "System Failure",
 "error_cd": "RET12501"
 },
 "status_code": 0
}