GST Return Filing and Reconciliation APIs Explained
How return filing and GSTR-2B reconciliation APIs work, what needs a GSP licence, and where plain GSTIN verification fits in the compliance stack.
"GST compliance API" is sold as one product and is really three. Filing submits returns on a taxpayer's behalf. Reconciliation matches your purchase records against GSTR-2B to protect input tax credit. Verification reads the public taxpayer record to tell you whether a counterparty is real, active and filing.
They have different licensing requirements, different price points by roughly two orders of magnitude, and different consequences when they fail. A mid-sized business evaluating "a GST compliance API" is usually being quoted for all three when it needs to buy them separately — and, importantly, in a particular order.
The three layers of a GST compliance stack
| Layer | Answers | Access needed | Typical pricing |
|---|---|---|---|
| Filing | Submit GSTR-1, GSTR-3B and others on a taxpayer behalf | GSP-grade access plus taxpayer authorisation | Per GSTIN or per return, usually annual |
| Reconciliation | Does my purchase register match GSTR-2B? | Access to your own GSTR-2B, plus a matching engine | Per GSTIN or by document volume |
| Verification | Is this counterparty real, Active and filing? | None — it is public data | Per lookup, ₹0.40–₹0.50 |
What a filing API actually does
A filing API takes structured invoice and summary data from your system and submits it to GST systems as a return, handling authentication, schema validation, the submit-and-file two-step and the acknowledgement that comes back. Because it acts on a taxpayer's behalf, it sits behind GSP-grade access and that taxpayer's authorisation.
What makes filing hard is rarely the transmission. It is everything upstream: your data has to be complete and correctly classified before it can be filed at all. HSN or SAC per line, place of supply derived correctly, credit notes linked to their originals, amendments handled as amendments rather than new documents. Filing surfaces every data quality problem you have, at a deadline, which is why teams find it painful. The returns themselves are explained in the GSTR-1 guide and the GSTR-3B guide, with deadlines in GST return due dates.
What a reconciliation API actually does
Reconciliation compares your purchase records against GSTR-2B — the auto-drafted statement of input tax credit available to you for a period, assembled from what your suppliers reported. The output is a set of buckets:
- Matched. Your invoice, their reported invoice, same values. No action.
- In 2B but not in your books. Usually an unbooked invoice or a document sent to the wrong place.
- In your books but not in 2B. The expensive one — your supplier has not reported it, and your credit on it is at risk until they do.
- Matched with differences. Amount, tax rate or invoice-number mismatches, usually requiring a tolerance rule and then a human.
- Duplicates. Almost always your side.
Two properties of GSTR-2B drive the design. It is static once generated for a period — it does not update as suppliers file late — so a missing invoice does not silently resolve itself inside that statement. And the Invoice Management System now sits in front of it, letting you accept, reject or keep documents pending before they flow into your 2B, which changes when in the month the work happens. Both are covered in GSTR-2B and the Invoice Management System.
Where GSTIN verification fits — and why it comes first
Reconciliation is a detection layer for problems that already happened. Verification is a prevention layer for a meaningful share of the same problems. Consider what actually produces the expensive reconciliation buckets:
| Reconciliation symptom | Underlying cause | Catchable earlier by |
|---|---|---|
| Invoice never appears in 2B | Supplier does not file, or is cancelled | Status and filing history at onboarding, then monitoring |
| GSTIN mismatch on the document | Wrong or mistyped GSTIN captured at onboarding | Format check plus verification at contact creation |
| Supplier reported under a different GSTIN | Multi-state supplier, wrong branch registration on file | Verification confirming the state code against place of supply |
| Plain invoice from an e-invoicing supplier | Supplier obliged to issue an IRN and did not | The e-invoicing eligibility flag on their GSTIN |
Every row is visible before the invoice is booked, for well under a rupee. That is the argument for putting the cheapest layer first: it reduces the volume flowing into the expensive layers. Screening designs are in vendor onboarding and daily vendor monitoring.
Choosing for a mid-sized business
The questions that actually separate options, in the order worth asking them:
- How many GSTINs do you file for? Multi-state registrations multiply everything, and per-GSTIN pricing is the norm. A business with twelve registrations is a very different customer from one with two.
- What is the real integration point? If your data lives in SAP, Tally or an ERP, the connector quality matters more than the feature list — see ERP integration, SAP and Tally.
- Who fixes an exception? An engine that produces 4,000 mismatches and no ownership model has moved the work rather than reduced it.
- Where does counterparty screening sit? Some suites include it at a price that only makes sense at their volumes. Priced separately, it is usually a rounding error — compare against per-lookup pricing.
- What happens at the deadline? Ask specifically how the platform behaves on the 20th, when the upstream systems are at their busiest and so is every other customer.
The order to build in
Businesses that sequence this well tend to go in the same order, and it is not the order vendors pitch.
- Verification first. Cheapest, no licensing, deployable in a day, and it improves the input data for everything after it. Screen the vendor master once, then monitor.
- Reconciliation second. Now running against a cleaner counterparty base, so the exception volume is lower and the exceptions that remain are genuine.
- Filing automation last. The highest-stakes layer, and the one that depends most on the data discipline the first two steps establish.
Doing it in reverse — automating filing on top of a vendor master nobody has screened — is how businesses end up with an expensive platform producing thousands of exceptions a month that trace back to data problems a ₹0.50 lookup would have caught at onboarding.
Frequently asked questions
A note on accuracy. GST rules change often. This article reflects our understanding as of 3 September 2026 and is general information, not tax or legal advice. For the authoritative position, check gst.gov.in and cbic-gst.gov.in, or speak to a qualified tax professional about your specific situation.
Check a GSTIN right now, free
Five lookups a day, no account required. Status, filing history, e-invoicing and jurisdiction.
Free GST search toolBuild it into your product
One REST call, JSON back. Get an API key and 20 free verification credits in under a minute.
Start freeMore on gst rules & compliance
Browse every guide in the GST API blog.