GST API | Direct GSP pipe to GSTN

GST API for Developers — File returns, pull 2A/2B,
validate GSTINs — over a real REST API.

The GST API for developers who actually have to ship. Direct GSP-licensed connection to GSTN. SDKs in 5 languages. 99.99% uptime SLA.

1import WhiteBooks from '@whitebooks/node'
2
3const client = new WhiteBooks({
4 apiKey: process.env.WB_API_KEY,
5 sandbox: false,
6});
7
8// File GSTR-3B for a return period
9const ret = await client.gst.fileGstr3b({
10 gstin: "29AAGCW7302R1ZF",
11 returnPeriod: "062026",
12 signType: "EVC",
13});
14
15console.log("ARN:", ret.arn)
200 OK·142ms

Three reasons most "GST APIs" disappoint developers.

01

Resold APIs add latency

Most 'GST APIs' on the market are resold from a real GSP — your request goes through their server before it reaches GSTN. That's 200–600ms of extra latency on every call. WhiteBooks holds its own GSP license. Your request goes one hop, not two.

02

XML, SOAP, and undocumented quirks

Some providers wrap the GSTN's underlying APIs without modernization — leaving you to handle XML payloads, SOAP envelopes, and undocumented error codes. WhiteBooks normalizes everything to clean JSON with well-typed errors.

03

Sandbox that doesn't match production

Sandbox environments at most providers respond differently from production — different rate limits, different error shapes, different success conditions. WhiteBooks sandbox is bit-for-bit identical to production behavior.

40+ ERP Integrations

SDKs, frameworks, and the tools you already use.

Official SDKs in Node.js, Python, PHP, Java, and Go. Community SDKs in Ruby, .NET, Elixir. All on github.com/whitebooks. First-class support for Express, FastAPI, Django, Laravel, Spring Boot, and Gin.

Real-time Sync

Native connectors for instant data flow

Always Up-to-date

Maintained against every ERP upgrade

Zero Manual Work

No CSV exports. No email uploads.

Enterprise Secure

Bank-grade security & data protection

40+
ERP Integrations
1000+
Customers using integrations
Real-time
Data Push
99.99%
Uptime SLA
  • Node.js
  • Python
  • PHP
  • Java
  • Go
  • Ruby
  • .NET
  • Postman
  • OpenAPI 3.1
  • Express
  • FastAPI
  • Django
  • Laravel

AI-friendly responses, AI-friendly tooling.

WhiteBooks runs a shared AI engine across every product. Trained on Indian compliance data, tuned for finance teams, and embedded in the workflows you already use.

01

Structured response shapes designed for LLM extraction

Every endpoint returns responses with consistent field naming and explicit type information. Easy to feed into agentic workflows or AI-driven reconciliation systems.

02

Inline error explanations

When GSTN rejects a return, the error code is returned alongside a plain-language explanation and a suggested fix. The kind of thing that saves you from grep-ing GSTN's PDF documentation at 2am.

03

Natural-language queries

Type "show me all October vendors with ITC variance above 10%" or "which clients haven't filed 3B for September?" — answers draw from your live data with source rows linked.

04

Use with the WhiteBooks AI engine

Combine the GST API with the WhiteBooks reconciliation models to build your own fraud detection, ITC optimization, or anomaly flagging — directly on your customers' data, in your product.

Frequently asked Questions.

Is WhiteBooks a GSP or a reseller?+
WhiteBooks holds a direct GSP license from GSTN, under BVM IT Consulting Services India Pvt. Ltd. We do not resell another GSP's pipe. This is the reason for the latency and uptime difference versus most other API providers.
How fast can I get production access?+
Sandbox is immediate. Production requires KYC verification and a signed agreement — median 5 business days from sandbox signup to production keys.
Can I file returns for my clients (as a CA firm or tax-tech product)?+
Yes. The API supports multi-GSTIN operation with delegated authentication. Each client GSTIN's credentials are stored encrypted with explicit consent.
What's the SLA?+
99.99% monthly uptime on production endpoints. SLA credits issued automatically. Public status page at whitebooks.in/status.
How do GST 2.0 rate changes affect my integration?+
The HSN endpoint returns current applicable rates as of the request date. Your code doesn't hard-code rates — you query for them. When the government changes rates, your integration doesn't break.
Do you support webhooks?+
Yes. HMAC-signed, replay-protected, with exponential backoff on delivery. Subscribe to GSTR filing events, notice events, 2B availability, and refund status changes.

Five minutes to your first sandbox call.

Sign up, get sandbox keys, run the quickstart. Production access in 5 business days after KYC. No procurement-cycle minimum — Startup tier starts at ₹14,999/month.

See pricing · Full API reference