GST Return Filing Status

Business & KYB

Month-by-month GST return filing history for a GSTIN.

Pull the return filing history behind a GSTIN: which returns were filed, when, and where the gaps are. Turn tax compliance into a measurable signal for supplier risk, credit decisions and input tax credit protection.

Endpoint

POST https://app.emver.io/api/sandbox/v1/gst-filing-status

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`g_s_t_i_n` required	string	GSTIN
`financial_year` optional	string	Financial year

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/gst-filing-status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "g_s_t_i_n": "string",
    "financial_year": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/gst-filing-status",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "g_s_t_i_n": "string",
        "financial_year": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/gst-filing-status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "g_s_t_i_n": "string",
      "financial_year": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/gst-filing-status', {
        "g_s_t_i_n": "string",
        "financial_year": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING,
  "data": {
    "filing_history_by_period_and_return_type": STRING,
    "filing_dates": STRING,
    "delayed_and_missing_periods": STRING,
    "overall_compliance_rating": STRING
  }
}

Example · 200

{
  "status": 200,
  "message": "string",
  "data": {
    "filing_history_by_period_and_return_type": "string",
    "filing_dates": "string",
    "delayed_and_missing_periods": "string",
    "overall_compliance_rating": "string"
  }
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

A registration can be active while returns go unfiled for months. The GST Return Filing Status API returns the filing record by period and return type, so you can see late filers and non-filers before they become a payment or credit problem.

Credit teams use the filing cadence as a proxy for operating activity; procurement uses it to protect input tax credit on purchases.

Typical uses

MSME and supply-chain finance. Filing cadence as an underwriting input.
Vendor risk monitoring. Re-check key suppliers each quarter.
Marketplace seller health. Flag sellers whose filings stop.
Audit and compliance reviews. Evidence for counterparty due diligence files.

Questions

Does it show the amounts filed?: It returns filing status, periods and dates, not the tax amounts or turnover in the returns.
How far back does it go?: Filing history is available for recent financial years; specify a year to narrow the response.