GST Filing Details

Business
POST /api/v1/gst/filing-details Bearer

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.

Availability

🗺 Country-specific

India

What GST Filing Details Is Used For

Supplier due diligence

Confirm a supplier filed GSTR-1 and GSTR-3B for the year before onboarding them or releasing a payment.

Protecting input tax credit

ITC depends on the supplier's GSTR-1 for the tax period. Check the return was filed before claiming against it.

Credit and lending decisions

An unbroken filing history is evidence of an operating business; missing periods and late ARNs are an early risk signal.

Portfolio compliance monitoring

Re-check a book of GSTINs each year and flag any that stopped filing, without asking them for documents.

Quick Start

1. Copy your API key from Dashboard → API Keys
2. Send a POST request to /api/v1/gst/filing-details
3. Pass the key as Authorization: Bearer <key>
4. Read the result from the data object in the JSON response

cURL

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"}'
🚀 Send Request
✓ Key saved

🔑 Remember API Key

One-click convenience for testing & troubleshooting — no account needed.

1

What it doesSaves your API key in this browser only using localStorage. Next time you open a docs page, the Try It panel is pre-filled automatically.

2

Auto-updatesIf you type a different key into any Try It field, the saved key is replaced instantly — only the most recent key is ever stored.

3

Uncheck to forgetUnchecking “Remember API Key” immediately deletes the stored key and clears the field. While unchecked, nothing is saved even if you type a new key.

4

Re-check to save againChecking the box again saves whatever key is currently in the Try It field.

⚠ Security note: Your key is stored only in your browser and is never sent to any server except as part of the actual API call you send. Do not use this feature on shared or public computers.

More on this API

Request Endpoint, authentication headers, every request parameter with its type, and a sample request body. Response The full success response payload, field by field. Error Codes HTTP status codes, error payload shape, and how to handle failures. Code Examples Ready-to-run examples in cURL, PHP, JavaScript and Python. Rate Limits Per-minute and per-day request limits, and what happens on breach. AI Agent / LLM The whole endpoint as one Markdown brief — paste into Claude, Cursor, Copilot or ChatGPT.