Business API

GST Filing Details

Every GST return a GSTIN filed in one financial year, read from the government record.

GST Filing Details
POST

GST Filing Details API — Every GST return a GSTIN filed in one financial year, read from the government record. Send a GSTIN and a year such as 2023-24 and receive one entry per return: the form (GSTR-1, GSTR-3B, GSTR-9, CMP-08 and the rest), the tax period as YYYY-MM, the ARN acknowledgement number, the date of filing as an ISO date, whether it was filed online or offline, and its status. This is how you check a counterparty's GST return filing status and compliance history before extending credit, onboarding a supplier, or claiming input tax credit — ITC depends on the supplier having actually filed, and a gap in GSTR-1 or GSTR-3B is the earliest signal that it is at risk. Entries are returned most recent tax period first, and filing_count reports how many were found for the year.

  • Coverage: India
  • Real-time business lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/gst/filing-details

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
gst_number string Yes 15-character GSTIN, e.g. 03DOXPM4071K1ZE. Case-insensitive.
financial_year string Yes Indian financial year (April to March), 2017-18 onwards. Accepts 2023-24, 2023-2024 or 202324.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/gst/filing-details", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "gst_number" => "03DOXPM4071K1ZE", "financial_year" => "2023-24" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/gst/filing-details", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "gst_number": "03DOXPM4071K1ZE", "financial_year": "2023-24" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/gst/filing-details \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"gst_number":"03DOXPM4071K1ZE","financial_year":"2023-24"}'
$.ajax({ url: "https://app.way2api.com/api/v1/gst/filing-details", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "gst_number": "03DOXPM4071K1ZE", "financial_year": "2023-24" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/gst/filing-details", {"gst_number":"03DOXPM4071K1ZE","financial_year":"2023-24"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/gst/filing-details", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "gst_number": "03DOXPM4071K1ZE", "financial_year": "2023-24" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "gst_number": "03DOXPM4071K1ZE",
            "financial_year": "2023-24",
            "filing_count": 16,
            "filings": [
                {
                    "return_type": "GSTR1",
                    "return_period": "2024-03",
                    "arn": "AA030324078315H",
                    "filed_on": "2024-04-08",
                    "filing_mode": "online",
                    "status": "filed",
                    "is_valid": true
                },
                {
                    "return_type": "GSTR3B",
                    "return_period": "2024-03",
                    "arn": "AA0303244598718",
                    "filed_on": "2024-04-19",
                    "filing_mode": "online",
                    "status": "filed",
                    "is_valid": true
                },
                {
                    "return_type": "GSTR1",
                    "return_period": "2024-02",
                    "arn": "AA0302241450008",
                    "filed_on": "2024-03-10",
                    "filing_mode": "online",
                    "status": "filed",
                    "is_valid": true
                }
            ]
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "Invalid GSTIN",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "INVALID_GSTIN",
        "result": {
            "gst_number": "03DOXPM4071K1ZZ",
            "financial_year": "2023-24",
            "filing_count": 0,
            "filings": []
        }
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login