--- title: "GST return filing status API India: price, fields" url: https://jurisgrid.com/solutions/gst-return-filing-status-api/ reviewed: 2026-11-13 type: solution sector: company-data --- # 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 2026 ## 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. ## Which API does it? **IndiaCos GST API** (JurisGrid score 85 of 100). Price: INR 0.40 per successful call, INR 50 free credit. INR 50 free credit on sign-up, no card needed. - `GET https://indiacos.com/api/v1/gst/{gstin}`: GST registration with the return_filings array - `GET https://indiacos.com/api/v1/gst/{gstin}?refresh=true`: Read the record from the GST portal now unless read in the last 30 days - MCP: https://indiacos.com/mcp - Docs: https://indiacos.com/api/docs?ref=jurisgrid ```bash curl -s -H "Authorization: Bearer $INDIACOS_API_KEY" \ "https://indiacos.com/api/v1/gst/27AAOCM9194L2ZF" ``` ## What does it return? - 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? | Provider | What they sell | Score | API | MCP | Price | |---|---|---|---|---|---| | [IndiaCos](https://jurisgrid.com/providers/indiacos/index.md) | IndiaCos GST API | 85 | Public REST API | Public MCP server | INR 0.40 per successful call, INR 50 free credit | | [Sandbox](https://jurisgrid.com/providers/sandbox-co-in/index.md) | Track GST Returns and Get Return Preference endpoints | 54 | Public REST API | Not published | Not published | | [GSTIN API](https://jurisgrid.com/providers/gstinapi-in/index.md) | 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 | INR 0.40 to 0.80 per lookup before GST | | [Surepass](https://jurisgrid.com/providers/surepass/index.md) | GST Return Status API | 36 | Public REST API | Not published | Not published | | [KnowYourGST](https://jurisgrid.com/providers/knowyourgst/index.md) | GST return filing details API by GSTIN and financial year | 12 | Not published | Not published | Not published | ## 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. ## Related - [Best GST verification APIs in India](https://jurisgrid.com/best/gst-verification-api-india/index.md) - [Best PAN to GST APIs in India](https://jurisgrid.com/best/pan-to-gst-api-india/index.md) - [Best KYB and business verification APIs in India](https://jurisgrid.com/best/kyb-business-verification-api-india/index.md) - [IndiaCos vs Surepass](https://jurisgrid.com/compare/indiacos-vs-surepass/index.md) - [IndiaCos vs GSTZen](https://jurisgrid.com/compare/indiacos-vs-gstzen/index.md) - [GSTZen vs Masters India vs IndiaCos](https://jurisgrid.com/compare/gstzen-vs-masters-india-vs-indiacos/index.md) - [B2B company search API](https://jurisgrid.com/solutions/b2b-company-search-api/index.md) - [CIN verification API](https://jurisgrid.com/solutions/cin-verification-api/index.md) - [Company litigation check API](https://jurisgrid.com/solutions/company-litigation-check-api/index.md) - [Company search by name API](https://jurisgrid.com/solutions/company-search-by-name-api/index.md) - [DIN verification API](https://jurisgrid.com/solutions/din-verification-api/index.md) - [Director details API](https://jurisgrid.com/solutions/director-details-api/index.md) - [GST search by name API](https://jurisgrid.com/solutions/gst-search-by-name-api/index.md) - [GST verification API](https://jurisgrid.com/solutions/gst-verification-api/index.md)