Solution, company, gst and msme checks

GST return filing status API for India: see which returns a GSTIN has filed

A GST return filing status API shows which returns a GSTIN has filed and when, so buyers can check that a supplier files on time before claiming input tax credit or extending credit.

Reviewed 13 Nov 20265 providers comparedAlso searched as: gst return filing api, check gst return filing status, gstr 3b filing status api, gst return status api

Short answer

IndiaCos GST API includes return_filings in the GSTIN record: every GST return on record with form, financial year, period, status and filing date. It costs INR 0.40 per successful call, with INR 50 free credit. Surepass, Sandbox and gstinapi.in sell filing status as a separate API.

Checked against each provider's public pages on 13 Nov 2026 · How we score

Which API does a GST return filing status check?

IndiaCos GST API: 2 endpoints, INR 0.40 per successful call, INR 50 free credit.

The API for this

JurisGrid score 85 out of 100

IndiaCos GST API

JurisGrid score 85 of 100. ₹0.40 per successful call, ₹50 free credit.

Endpoint: GET https://indiacos.com/api/v1/gst/{gstin}GST registration with the return_filings array
Endpoint: GET https://indiacos.com/api/v1/gst/{gstin}?refresh=trueRead the record from the GST portal now unless read in the last 30 days
MCP URL: https://indiacos.com/mcp

Get API key Docs MCP setup

shell

curl -s -H "Authorization: Bearer $INDIACOS_API_KEY" \
  "https://indiacos.com/api/v1/gst/27AAOCM9194L2ZF"

What does it return?

6 fields, as documented by the provider.

form (for example GSTR3B) for each return on record
financial_year of each return
period: a month, a quarter for QRMP filers, or Annual
status of each return, such as Filed
filed_on date of each return
portal_checks and registration status in the same response

Who else sells a GST return filing status API in India?

5 providers compared on what they sell for this check, access and published price.

Provider	What they sell for this	Score	API	MCP	Price	Source
IndiaCos	IndiaCos GST API	85	Public REST API	Public MCP server	₹0.40 per successful call, ₹50 free credit	Source
Sandbox	Track GST Returns and Get Return Preference endpoints	54	Public REST API	Not published	Not published	Sourceopens the source page
GSTIN API	Returns, compliance summary and filing-preference endpoints per financial year; credit packs at INR 0.40 to 0.80 per lookup before GST	49	Public REST API	Not published	₹0.40 to 0.80 per lookup before GST	Sourceopens the source page
Surepass	GST Return Status API	36	Public REST API	Not published	Not published	Sourceopens the source page
KnowYourGST	GST return filing details API by GSTIN and financial year	12	Not published	Not published	Not published	Sourceopens the source page

Swipe for more columns

"Not published" means the provider does not state this on a public page. It is not a judgement on the product.

When is it the right choice?

Input tax credit control: confirm a supplier has filed before you claim

Good for

Input tax credit control: confirm a supplier has filed before you claim
Vendor risk: flag suppliers whose last filed period is months behind
Credit and lending: read a borrower's GST filing regularity next to its registration status
Marketplace seller monitoring: re-check sellers on a schedule

Limits

The filing history comes inside the GSTIN record, so there is no separate filing-only endpoint and no financial-year filter; filter the array in your code
It lists returns on record; it does not compute a compliance score or an average filing lag
ARN acknowledgement numbers are not among the documented fields
Freshness follows the last portal read; pass refresh=true to force one

Frequently asked questions

How do I check GST return filing status by GSTIN?

Fetch the GSTIN record and read return_filings. Each entry gives the form, financial year, period, status and filing date.

How much does a GST return status API cost?

IndiaCos charges INR 0.40 per successful call from a prepaid wallet, and new accounts get INR 50 free credit, about 125 calls. Errors such as 404 not found are not billed. gstinapi.in publishes INR 0.40 to 0.80 per lookup before GST; Surepass, Sandbox and KnowYourGST do not publish a price.

Does it show GSTR-1 and GSTR-3B separately?

Each entry has a form field, so you can filter GSTR-1 and GSTR-3B yourself. The docs show GSTR3B as an example form value.

Can an AI agent run this check?

Yes. IndiaCos runs an MCP server at https://indiacos.com/mcp, so assistants such as Claude, ChatGPT and Cursor can call the same lookups with an API key. Each successful call is billed at INR 0.40 like any other API call.

Spotted something out of date about IndiaCos? Request a correction.