GST API Integration in India

A practical guide to integrating the WhiteBooks GST API — covering OAuth 2.0 authentication, return filing (GSTR-1 / 3B / 9), GSTR-2B reconciliation, GSTIN verification, and HSN/SAC lookup. Sandbox to production in under an hour with the Java, Node.js, or Python SDK.

Overview

The WhiteBooks GST API is a GSP-certified REST API set that lets developers programmatically file GST returns, fetch GSTR-2B for ITC reconciliation, verify GSTINs, and look up HSN/SAC codes. It runs through the official GSP channel to GSTN — no screen-scraping.

Why this stack

5-minute quickstart

  1. Sign up at /about/contact-us — sandbox credentials arrive within one business day
  2. Exchange client_id + client_secret for an OAuth 2.0 bearer token (1-hour validity)
  3. Hit apisandbox.whitebooks.in/gst/api/v1/gstr2b/fetch with the bearer token
  4. Validate the response matches your purchase register
  5. Switch base URL to api.whitebooks.in/gst for production

Primary endpoints

OperationMethod + path
File GSTR-1POST /gst/api/v1/gstr1/file
File GSTR-3BPOST /gst/api/v1/gstr3b/file
File GSTR-9POST /gst/api/v1/gstr9/file
Fetch GSTR-2BPOST /gst/api/v1/gstr2b/fetch
Verify GSTINGET /gst/api/v1/gstin/{gstin}
HSN/SAC searchGET /gst/api/v1/hsn-sac/search?q=...

ERP integration

Pre-built connectors ship for SAP ECC 6.0+ / S/4HANA, Oracle EBS / Fusion, Microsoft Dynamics 365 Business Central, and Tally Prime / ERP 9. Custom ERPs and accounting platforms integrate via plain REST + JSON.

FAQs

Is the API GSP-certified?

Yes — WhiteBooks holds GSP certification from GSTN. Every call routes through the official authorized channel.

Can I test without a paid plan?

Yes — the sandbox at apisandbox.whitebooks.in/gst is free with a sample GSTIN. The full API surface is available.

What about rate limits?

Sandbox is throttled at 60 req/min/key. Production tiers range from 100 req/s (Starter) to burst-rate dedicated capacity (Enterprise).

Part of the WhiteBooks developer documentation cluster. See /llms.txt for the full machine-readable site index. Last updated 27 May 2026.