Track GST Return

Testing Data

GSTIN

Financial Year

Response

Remark

24AAACJ3770E2ZV

FY 2019-20

200

Success response

08AAACS8577K1ZP

FY 2019-20

503

Source Unavailable response

get
Track GST Return

https://api.sandbox.co.in/gsp/public/gstr?gstin={{gstin}}&financial_year={{financial_year}}
This API will be used to view e-filed returns details.
Request
Response
Request
Headers
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access.
x-api-version
optional
string
Query Parameters
gstin
required
string
15-character alphanumeric unique identifier assigned to business entities registering under the GST regime
financial_year
required
string
e.g. FY 2019-20
Response
200: OK
Success
No records found
Invalid GSTIN
Please select a valid financial year
Success
{
"data": {
"EFiledlist": [
{
"valid": "Y",
"mof": "ONLINE",
"dof": "12-01-2021",
"ret_prd": "122020",
"rtntype": "GSTR3B",
"arn": "AA241220607741S",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-01-2021",
"ret_prd": "122020",
"rtntype": "GSTR1",
"arn": "AA241220467116N",
"status": "Filed"
},
{
"mof": "ONLINE",
"dof": "03-01-2021",
"ret_prd": "032019",
"rtntype": "GSTR9",
"arn": "AA2403191367915",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-12-2020",
"ret_prd": "112020",
"rtntype": "GSTR3B",
"arn": "AA241120329191Y",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-12-2020",
"ret_prd": "112020",
"rtntype": "GSTR1",
"arn": "AA241120348341W",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "22-11-2020",
"ret_prd": "102020",
"rtntype": "GSTR3B",
"arn": "AA2410209984086",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-11-2020",
"ret_prd": "102020",
"rtntype": "GSTR1",
"arn": "AA241020459048M",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-11-2020",
"ret_prd": "092020",
"rtntype": "GSTR3B",
"arn": "AB240920163334D",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "13-10-2020",
"ret_prd": "092020",
"rtntype": "GSTR1",
"arn": "AA240920502201Z",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "07-09-2020",
"ret_prd": "082020",
"rtntype": "GSTR1",
"arn": "AA240820161052R",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "07-09-2020",
"ret_prd": "082020",
"rtntype": "GSTR3B",
"arn": "AA2408201609075",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-08-2020",
"ret_prd": "072020",
"rtntype": "GSTR1",
"arn": "AA240720219512O",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "10-08-2020",
"ret_prd": "072020",
"rtntype": "GSTR3B",
"arn": "AA240720219384H",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "17-07-2020",
"ret_prd": "062020",
"rtntype": "GSTR1",
"arn": "AA240620444481K",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "17-07-2020",
"ret_prd": "062020",
"rtntype": "GSTR3B",
"arn": "AA240620506151Y",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "15-07-2020",
"ret_prd": "042020",
"rtntype": "GSTR1",
"arn": "AA2404209719733",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "15-07-2020",
"ret_prd": "052020",
"rtntype": "GSTR1",
"arn": "AA2405208857805",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-07-2020",
"ret_prd": "042020",
"rtntype": "GSTR3B",
"arn": "AA240420950978Y",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "11-07-2020",
"ret_prd": "052020",
"rtntype": "GSTR3B",
"arn": "AA240520851461L",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "04-07-2020",
"ret_prd": "032020",
"rtntype": "GSTR1",
"arn": "AB240320330504V",
"status": "Filed"
},
{
"valid": "Y",
"mof": "ONLINE",
"dof": "30-06-2020",
"ret_prd": "032020",
"rtntype": "GSTR3B",
"arn": "AB240320269715A",
"status": "Filed"
}
]
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
No records found
{
"data": {
"error_code": "RET13510",
"message": "No Record found for the provided Inputs"
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Invalid GSTIN
{
"data": {
"error_code": "SWEB_9035",
"message": "Invalid GSTIN / UID"
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Please select a valid financial year
{
"data": {
"error_code": "RTN_22",
"message": "Please select a valid financial year"
},
"code": 200,
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
401: Unauthorized
{
"code": 401,
"message": "Unauthorized",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
403: Forbidden
Invalid token
Access denied
Insufficient credits
Invalid token
{
"code": 403,
"message": "Not a valid token",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Access denied
{
"code": 403,
"message": "Access denied",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
Insufficient credits
{
"code": 403,
"message": "Insufficient credits",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
422: Unprocessable Entity
Invalid GSTIN Pattern
Invalid GSTIN Pattern
{
"code": 422,
"message": "Invalid GSTIN pattern",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}
500: Internal Server Error
Internal Server Error
Internal Server Error
{
"code": 500,
"message": "Internal Server Error",
"timestamp": 1614696176218,
"transaction_id": "611335dc-8be4-40d1-8438-b86526462939"
}

JWT Authorization token can be obtained by calling the Authenticate API

Example Request

cURL
Java
Node.js
Python
cURL
curl --location --request GET 'https://api.sandbox.co.in/gsp/public/gstr?gstin=24AAACJ3770E2ZZ&financial_year=FY%202017-18' \
--header 'Authorization: eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw' \
--header 'x-api-key: key_live_Ade**************************Uxs' \
--header 'x-api-version: 3.4.0'
Java
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://api.sandbox.co.in/gsp/public/gstr?gstin=24AAACJ3770E2ZZ&financial_year=FY%202017-18")
.header("Authorization", "eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw")
.header("x-api-key", "key_live_Ade**************************Uxs")
.header("x-api-version", "3.4.0")
.asString();
Node.js
var https = require('follow-redirects').https;
var fs = require('fs');
var options = {
'method': 'GET',
'hostname': 'https://api.sandbox.co.in',
'path': '/gsp/public/gstr?gstin=24AAACJ3770E2ZZ&financial_year=FY%202017-18',
'headers': {
'Authorization': 'eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw',
'x-api-key': 'key_live_Ade**************************Uxs',
'x-api-version': '3.4.0'
},
'maxRedirects': 20
};
var req = https.request(options, function (res) {
var chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function (chunk) {
var body = Buffer.concat(chunks);
console.log(body.toString());
});
res.on("error", function (error) {
console.error(error);
});
});
req.end();
Python
import requests
url = "https://api.sandbox.co.in/gsp/public/gstr?gstin=24AAACJ3770E2ZZ&financial_year=FY 2017-18"
payload = {}
headers = {
'Authorization': 'eyJhbGciOiJIUzUxMiJ9.eyJhdWQiOiJBUEkiLCJyZWZyZXNoX3Rva2VuIjoiZXlKaGJHY2lPaUpJVXpVeE1pSjkuZXlKaGRXUWlPaUpCVUVraUxDSnpkV0lpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1Gd2FWOXJaWGtpT2lKclpYbGZiR2wyWlY5QlpHVXFLaW9xS2lvcUtpb3FLaW9xS2lvcUtpb3FLaW9xS2lvcUtsVjRjeUlzSW1semN5STZJbUZ3YVM1eGRXbGphMjh1WTI5dElpd2laWGh3SWpveE5Ua3dPVFk1TmpBd0xDSnBiblJsYm5RaU9pSlNSVVpTUlZOSVgxUlBTMFZPSWl3aWFXRjBJam94TlRVNU16UTNNakF3ZlEueHNmYkhQTERFRlRvTy1OUWdaUUpLM25OUjFxdlhvWmhaOHRqS3gzSExydjZiVkJaMHpJZEZ5ai1MUTg1YnJZS0xXQnFnZHlzZ1NDSXlDUXNtV2VOYkEiLCJzdWIiOiJqb2huQGRvZS5jb20iLCJhcGlfa2V5Ijoia2V5X2xpdmVfQWRlKioqKioqKioqKioqKioqKioqKioqKioqKipVeHMiLCJpc3MiOiJhcGkucXVpY2tvLmNvbSIsImV4cCI6MTU5MTA1NjAwMCwiaW50ZW50IjoiQUNDRVNTX1RPS0VOIiwiaWF0IjoxNTkwOTY5NjAwfQ.nH23CR5RHGQ0U19I_vq3vyJ_85A1a2iEMQij5QHgJQdDuS9x7FmTidsr1CQabSFF5ujE40SFxHv1gJM20TauUw',
'x-api-key': 'key_live_Ade**************************Uxs',
'x-api-version': '3.4.0'
}
response = requests.request("GET", url, headers=headers, data = payload)
print(response.text.encode('utf8'))