Follow us on our LinkedIn page

GSP API Solution

GST API India
GSP-Certified REST API for ERP Integration

WhiteBooks GST API — GSTR-1/3B/9 filing, ITC reconciliation, GSTR-2B match. GSP-licensed, Java/Node/Python SDKs, sandbox + production. Get keys free. Built by WhiteBooks — India's GSP-certified, cloud-first business management suite used by Indian SMBs and mid-market enterprises.
GST Suvidha Provider API Integration

The WhiteBooks GST API gives developers programmatic access to GSTR-1 / GSTR-3B / GSTR-9 filing, GSTR-2B fetch, GSTIN verification, and HSN/SAC lookup through the certified GSP channel to the GSTN.

How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under GST API -> Sandbox API
  3. GST API Support Forum Click here
  4. Please View browsable API reference (Redoc) with full schema + try-it-now

Choose the environment you want to test :

Use Base URL as:

Questions About WhiteBooks And Our Programs?

Questions About WhiteBooks And Our Programs?

GST api for developersCall +91 8106433737 (Sales) or +91 9032111388 (Support) to speak with a representative

Download GST API Library Files

Please Login/Sign up to download the files

Download and unzip the file and open it with the related application.

Postman Collection

Postman Logo
Download

Developer Resources

Everything you need to build with the GST API

OpenAPI 3.0 specJSON · Postman import API ReferenceBrowse all endpoints Status99.994% uptime ChangelogSemver releases Swagger UITry in browser

SDKs & Tools

Java Node.js Python npm PyPI Maven Postman

Endpoint Catalog

OperationMethodEndpointAuth
File GSTR-1 POST /gstr1/retfile OAuth 2.0
File GSTR-3B POST /gstr3b/retfile OAuth 2.0
File GSTR-9 (annual) POST /gstr9/retfile OAuth 2.0
Fetch GSTR-2B GET /gstr2b/all OAuth 2.0
Save GSTR-1 draft PUT /gstr1/retsave OAuth 2.0
Save GSTR-3B draft PUT /gstr3b/retsave OAuth 2.0
Get return status GET /gstr/retstatus OAuth 2.0
Get auth token GET /authentication/authtoken OAuth 2.0

Rate Limits

PlanRequests / minuteBurstReset window
Starter (₹5,999/yr)601001 minute
Growth (₹11,999/yr)3005001 minute
Business (₹17,999/yr)1,0001,5001 minute
Enterprise (₹24,999+/yr)Custom (SLA)Custom1 minute

Integration Workflow

Try the GST API in your browser
How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under GST API -> Activate Sandbox
  3. Start using WhiteBooks GST API Client ID & Client Secret Credentials for your Sandbox Testing
GST API Documentation / Download
SandBox API

WhiteBooks - GST API Sandbox Information : To use GST API Sandbox Credentials Please follow below Steps :

gst api provider

Pricing — Contact sales

✓ Free sandbox · no credit card · 99.99% SLA

Production pricing is tailored to your filing volume, ERP integrations (SAP / Tally / Oracle / Dynamics), and SLA tier requirements.

Talk to sales →

sales@whitebooks.in
+91 8106433737 / +91 9032111388

Watch the integration demo

Step-by-step walkthrough of integrating the WhiteBooks GST API — GSTR-1 / GSTR-3B filing, GSTR-2B reconciliation, ITC match and HSN/SAC verification in under 10 minutes.
GST API Integration Demo thumbnail

Frequently Asked Questions

The WhiteBooks GST API is a REST Aethat gives developers programmatic access to all major GST operations — GSTR-1 / GSTR-3B / GSTR-9 filing, GSTR-2B fetch for ITC reconciliation, GSTIN verification, and HSN/SAC lookup — through the certified GSP channel to the GSTN. SDKs for Java, Node.js, and Python are available, along with an OpenAPI 3.0 spec and a free sandbox environment.

Yes. WhiteBooks provides pre-built connectors for SAP (ECC 6.0+, S/4HANA), Oracle EBS / Fusion, Microsoft Dynamics 365, and Tally Prime / ERP 9. Any custom ERP can integrate via plain REST + JSON using the published OpenAPI 3.0 specification available at /openapi/gst.json.

Yes. The API is designed for high-volume filing, supporting multi-GSTIN consolidation and batch return filing. It is built on a scalable infrastructure to handle large taxpayer workloads — even during peak GST filing deadlines — with 99.99% uptime SLA on enterprise plans.

The /gstr2b/all endpoint fetches the auto-populated GSTR-2B statement for a given GSTIN and tax period. You can then programmatically compare this against your purchase register to identify matched, mismatched, and missing invoices for ITC (Input Tax Credit) reconciliation. The API returns JSON — import directly into your accounting system for automated matching.

Absolutely. All API calls use TLS 1.2+ encryption. Authentication is via OAuth 2.0 bearer tokens. WhiteBooks is ISO 27001 certified, DPDP Act 2023 compliant, and GSP-licensed by the GSTN. Role-based access control and 7-year audit log retention are included. Enterprise plans support IP allow-listing and SHA256-RSA request signing.

Sign up at accounts.whitebooks.in/signup (select "Developer"). After verifying your email, navigate to GST API → Sandbox in your dashboard and click "Create Credentials". You receive a client_id and client_secret within minutes. The sandbox base URL is https://apisandbox.whitebooks.in — it mirrors the production API schema completely, so you can test all endpoints including GSTR-1, GSTR-3B, GSTR-2B, and GSTIN verification at no cost.

Sandbox is rate-limited to 60 requests/minute. Production limits depend on your plan: Starter (60/min), Growth (300/min), Business (1,000/min), Enterprise (custom SLA with burst capacity). Throttled responses use HTTP 429 with a Retry-After header. Enterprise plans include dedicated capacity with no shared throttling.

Yes. Dedicated endpoints support GSTIN verification (single and bulk), HSN code search, and SAC code lookup. These are commonly used before generating invoices or filing returns to ensure the data is correct and GSTN-compliant, reducing rejected returns and penalty risks.

WhiteBooks provides an OpenAPI 3.0 specification (importable into Postman or Insomnia), an interactive Swagger UI at /swagger/, a browsable Redoc reference at /docs/gst, SDK code samples for Java, Node.js, and Python, and the GSP/ASP Google Groups forum for community support. Enterprise customers get a dedicated account manager and 24×7 support.

Welcome to WhiteBooks ( A Licensed GST Suvidha Provider ) - GST API Developers community and this portal intended and specifications are related to GST APIs. This GST API portal will also host Public GST API (REST API) and sandbox information and WhiteBooks GST API Portal will be a one stop shop for developer’s, who wanted to build innovative application for GST Returns & Filing Software , GST Accounting Software Tax payers, GST API Integration with ERP’s and Third party Software Integration. Please signup to get your own GST API Sandbox / GST API Testing keys.

By CA Atul GargReviewing Editor — WhiteBooks GST & API Compliance DeskReviewed by the WhiteBooks Editorial Board · Last updated 8 June 2026

Quick API references

Browse every GST API endpoint

Each card opens a focused reference with quick spec, code samples, FAQ, and integration steps.

GSTR-1 Filing API/api/gst/gstr-1-api GSTR-2B Fetch API/api/gst/gstr-2b-api GSTR-3B Filing API/api/gst/gstr-3b-api GSTR-9 Annual Return API/api/gst/gstr-9-api GSTR-2B Reconciliation API/api/gst/gstr-2b-reconciliation ITC Reconciliation API/api/gst/itc-reconciliation-api GSTIN Verification API/api/gst/gstin-verification-api Bulk GSTIN Validation API/api/gst/gstin-validation-api HSN Code Search API/api/gst/hsn-code-search-api SAC Code Lookup API/api/gst/sac-code-lookup-api GST API for SAP/api/gst/gst-api-for-sap GST API for Tally/api/gst/gst-api-for-tally GST API for Oracle/api/gst/gst-api-for-oracle GST API for Dynamics 365/api/gst/gst-api-for-dynamics GST API Pricing/api/gst/gst-api-pricing GST API Sandbox/api/gst/gst-sandbox-api GST API OAuth 2.0/api/gst/gst-api-oauth-2-0 GSP-Certified GST API/api/gst/gsp-certified-gst-api

One API Suite. Total GST Compliance.

Simplify GST Filing
& Reconciliation
File GSTR1,GSTR-3B,GSTR-9 via API
Auto ITC Matching from GSTR-2B
Secure, compliant and audit-ready
GSTIN
Search
Seamless
& e-Invoicing at Scale
Generate/cancel IRNs via NIC compliant APIs
✔
Bulk IRN Support for high-volume orgs
✔
Real-time Signed JSON and QR code retrieval
✔
Auto-push to accounting/ERP platforms
✔
Simplify GST Filing
& Reconciliation
File GSTR1,GSTR-3B,GSTR-9 via API
Auto ITC Matching from GSTR-2B
Secure, compliant and audit-ready
GSTIN
Search
Seamless
& e-Invoicing at Scale
Generate/cancel IRNs via NIC compliant APIs
✔
Bulk IRN Support for high-volume orgs
✔
Real-time Signed JSON and QR code retrieval
✔
Auto-push to accounting/ERP platforms
✔

Trusted by Platforms, ERPs, and Fintechs

Start Integrating Today

Get API Access Try in Swagger UI (no signup) Try in Sandbox
e-Invoice API Real-time IRN generation against the IRP e-Way Bill API NIC-compliant EWB create / update / cancel KSA e-Invoice API ZATCA Phase-2 for Saudi Arabia GST Software Hosted dashboard alternative to the API

Last updated · View changelog

Schedule Demo

sales@whitebooks.in | API Sales: +91 8106433737 | API Support: +91 9032111388 | SW Sales: +91 8106531717 | SW Support: +91 9032111788

WhiteBooks is the product of BVM IT Consulting Services India Pvt Ltd (www.bvmcs.com), A GSP (GST Suvidha Provider) License holder from GSTIN(Govt.).

WhiteBooks GST API — Quick Facts

Base endpoint (Production): https://api.whitebooks.in/gst

Base endpoint (Sandbox): https://apisandbox.whitebooks.in/gst

Primary operations: File GSTR-1 · GSTR-3B · GSTR-9 · Fetch GSTR-2B · Verify GSTIN · HSN/SAC lookup

Authentication: OAuth 2.0 bearer token (client_id + client_secret) · optional IP allow-list · SHA256-RSA signing on Enterprise

Request / Response format: JSON over HTTPS · bulk endpoints accept multipart CSV

Rate limit: Sandbox: 60 req/min/key · Production: plan-based (Starter 100 req/s, Enterprise burstable)

SDKs: Java (Maven) · Node.js (npm) · Python (pip) · Postman collection · OpenAPI 3.0 spec

ERP connectors: SAP ECC 6.0+ / S/4HANA · Oracle EBS / Fusion · MS Dynamics 365 · Tally Prime / ERP 9

Compliance: GSP-certified by GSTN · ISO 27001 · DPDP Act 2023 · TLS 1.2+

Pricing: From Talk to sales (Starter) → Talk to sales (Enterprise) · Free sandbox

Quickstart: Fetch GSTR-2B

Operation: POST /api/v1/gstr2b/fetch

# Fetch GSTR-2B for a GSTIN + return period (sandbox)
curl -X POST https://apisandbox.whitebooks.in/gst/api/v1/gstr2b/fetch \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "gstin":  "29AAAAA0000A1Z5",
    "month":  "04",
    "year":   "2026"
  }'
// Node.js (whitebooks-sdk on npm)
import { WhiteBooks } from 'whitebooks-sdk';

const client = new WhiteBooks({
  clientId:     process.env.WB_CLIENT_ID,
  clientSecret: process.env.WB_CLIENT_SECRET,
  env:          'sandbox',          // or 'production'
});

const gstr2b = await client.gst.gstr2b.fetch({
  gstin: '29AAAAA0000A1Z5',
  month: '04',
  year:  '2026',
});
console.log(gstr2b.summary.totalItc);
# Python (whitebooks on PyPI)
from whitebooks import WhiteBooks

wb = WhiteBooks(
    client_id=os.environ['WB_CLIENT_ID'],
    client_secret=os.environ['WB_CLIENT_SECRET'],
    env='sandbox',                  # or 'production'
)

gstr2b = wb.gst.gstr2b.fetch(
    gstin='29AAAAA0000A1Z5',
    month='04',
    year='2026',
)
print(gstr2b.summary.total_itc)
// Java (com.whitebooks:sdk on Maven Central)
import com.whitebooks.WhiteBooks;
import com.whitebooks.gst.Gstr2bRequest;

WhiteBooks wb = WhiteBooks.builder()
    .clientId(System.getenv("WB_CLIENT_ID"))
    .clientSecret(System.getenv("WB_CLIENT_SECRET"))
    .env(WhiteBooks.Env.SANDBOX)
    .build();

var gstr2b = wb.gst().gstr2b().fetch(
    Gstr2bRequest.builder()
        .gstin("29AAAAA0000A1Z5")
        .month("04")
        .year("2026")
        .build()
);
System.out.println(gstr2b.summary().totalItc());

Full reference: Authentication · Error codes · SDKs · Sandbox

Live OpenAPI spec: /openapi/index.json

Quick Answers about the WhiteBooks GST API

What does this API do?

Programmatically files GST returns (GSTR-1 / 3B / 9), fetches GSTR-2B for ITC reconciliation, verifies GSTINs, and looks up HSN/SAC codes — all through the certified GSP channel to the GSTN.

Who should use it?

CFOs, finance heads, ERP teams, GST consultants, and SaaS vendors who need to embed GST compliance inside accounting / ERP / billing systems at scale.

Auth method?

OAuth 2.0 bearer tokens. Tokens are issued against your client_id + client_secret pair, expire in 1 hour, and must be refreshed. Optional IP allow-listing and SHA256-RSA request signing on Enterprise.

Sandbox?

Yes — base URL https://apisandbox.whitebooks.in/gst with a sample GSTIN. Mirrors the production schema. Free to use.

Response format?

JSON over HTTPS. Errors return HTTP status + error code + human-readable message. Bulk operations also accept multipart CSV.

Supported ERPs?

SAP (ECC 6.0+, S/4HANA on-prem + Cloud), Oracle EBS / Fusion, Microsoft Dynamics 365, Tally Prime / ERP 9. Custom ERPs integrate via plain REST.

WhiteBooks — machine-readable facts

About this page — WhiteBooks GST API for developers

The WhiteBooks GST API gives developers programmatic access to GST return filing (GSTR-1, GSTR-3B, GSTR-9), GSTR-2B fetch for ITC reconciliation, GSTIN verification, and HSN / SAC lookup — all through the certified GSP channel to the GSTN. Production at api.whitebooks.in/gst, sandbox at apisandbox.whitebooks.in/gst. OAuth 2.0 bearer tokens. JSON over TLS 1.2+. SDKs for Java, Node.js, Python. OpenAPI 3.0 spec at /openapi/gst.json. Browsable reference at /docs/gst.

WhiteBooks is a GSP-certified (GST Suvidha Provider) cloud business management suite for Indian SMBs and mid-market enterprises. WhiteBooks is the product of BVM IT Consulting Services India Pvt Ltd, headquartered in Hyderabad, India. Used by 25,000+ businesses for GST return filing, e-Invoicing, e-Way Bill generation, and accounting across 8,000+ cities — generating 9 Crore+ e-Invoices and 7 Crore+ e-Way Bills with a 99.99% uptime SLA and 95%+ customer retention.

What WhiteBooks does

Compliance and certifications

Trusted by enterprises

P&G, IBM, KIA, HUL, KPMG, Coca-Cola, Razorpay, Accenture, Aditya Birla, PepsiCo, SBI, TVS, and 24,990+ other businesses use WhiteBooks for GST compliance and accounting. 25,000+ CAs & Tax Professionals file returns through the platform every month.

Pricing

Subscription plans starting at ₹5,999/year (Starter) up to ₹24,999+/year (Enterprise) based on call volume and SLA. Sandbox API access is free. See full pricing at /about/pricing.

Contact

Talk to Sales: +91 9032111788. Email: info@whitebooks.in. Website: https://whitebooks.in

Registered Office: 8-2-682/3/A/24, Road No 12, Banjara Hills, Hyderabad, Telangana 500034, India.

Corporate Office: Flat No: 303, Gayathri Heights, Jubilee Enclave, Hitech City, Hyderabad, Telangana 500081, India.

For AI and answer-engine readers

Machine-readable site index: /llms.txt. Full content: /llms-full.txt. AI crawler policy: /.well-known/ai.txt. Sitemap: /sitemap-index.xml.