GST Filing Details

Retrieve GST return filing history for a GSTIN in a given financial year, including return type, filing dates, ARN numbers, status, and mode. Use this to assess filing compliance of business partners.

Endpoint

GET /vas-api/v1/gst-filing-details

Authentication

Requires OAuth2 Bearer token. Get your credentials →

Request

Headers

Header	Type	Required	Description
Authorization	string	Yes	Bearer YOUR_ACCESS_TOKEN

Query parameters

Parameter	Type	Required	Description	Example
gstin	string	Yes	15-character GSTIN	29ABCDE1234F1Z5
financialYear	string	Yes	Financial year (YYYY-YYYY)	2024-2025

Example request

curl

curl -X GET "https://api.api4business.com/vas-api/v1/gst-filing-details?gstin=29ABCDE1234F1Z5&financialYear=2024-2025" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Python

import requests

response = requests.get(
  "https://api.api4business.com/vas-api/v1/gst-filing-details",
  params={"gstin": "29ABCDE1234F1Z5", "financialYear": "2024-2025"},
  headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"}
)
print(response.json())

Node.js

const url = new URL("https://api.api4business.com/vas-api/v1/gst-filing-details");
url.searchParams.set("gstin", "29ABCDE1234F1Z5");
url.searchParams.set("financialYear", "2024-2025");
const response = await fetch(url, {
  headers: { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
});
console.log(await response.json());

Java

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://api.api4business.com/vas-api/v1/gst-filing-details?gstin=29ABCDE1234F1Z5&financialYear=2024-2025"))
  .header("Authorization", "Bearer YOUR_ACCESS_TOKEN")
  .GET().build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

Success (200)

The body is an array of filing records.

Field	Type	Description
ok	boolean	true if successful
responseCode	integer	HTTP status code
message	string	Status message
body[].gstin	string	The GSTIN
body[].financialYear	string	Financial year
body[].gstReturnType	string	Return type (GSTR1, GSTR3B, GSTR7, etc.)
body[].arnNumber	string	Acknowledgement Reference Number
body[].filingPeriod	string	Filing period (MMYYYY format, e.g., 022024 for Feb 2024)
body[].filingDate	string	Date filed (YYYY-MM-DD)
body[].filingStatus	string	Filed or Not Filed
body[].filingValidity	string	Y = valid, N = invalid
body[].filingMode	string	ONLINE or OFFLINE
body[].filingYear	string/null	Filing year if different from financial year
body[].lastSynced	integer	Last sync timestamp from GSTN portal

Example response

{
  "ok": true,
  "responseCode": 200,
  "message": "Transmission OK",
  "body": [
    {
      "gstin": "29ABCDE1234F1Z5",
      "financialYear": "2023-2024",
      "gstReturnType": "GSTR3B",
      "arnNumber": "AA290324012345A",
      "filingPeriod": "022024",
      "filingDate": "2024-03-19",
      "filingStatus": "Filed",
      "filingValidity": "Y",
      "filingMode": "ONLINE",
      "filingYear": null,
      "lastSynced": 1725363347472
    }
  ]
}

Response headers

Header	Description
x-request-id	Unique request identifier — log this for debugging and support

Error responses

Status	Error Code	Message	Resolution
400	400	Invalid GSTIN	Check 15-character GSTIN format
400	400	Invalid Request	Verify both gstin and financialYear are present
401	401	Invalid Credentials	Access token expired — request a new one
429	429	Quota Violation	Rate limit exceeded — retry with backoff
500	500	Internal Server Error	Retry after delay
503	503	Service Not Available	GSTN service temporarily down — retry

Related

• Filing Preference — Filing frequency preferences
• GSTIN Rating — Monthly compliance scores
• GSTIN Status — Registration details
• GST Overview