File
GSTR-1, GSTR-3B,
GSTR-9 via API
GST APIs, e-Invoice APIs, and e-Way Bill APIs — Secure, Scalable, and Developer-Friendly.
Get API Access View Documentation See Live DemoIndia's GSP-certified gateway for tax compliance. Public OpenAPI 3.0 specs, Java / Node.js / Python SDKs, free sandbox, 99.99% uptime SLA. Integrate in hours.
Complete REST API documentation with examples
Test integration before going live — full API surface, no paid plan needed
Java, Python, Node.js, .NET libraries — first-party and actively maintained
Detailed error messages with actionable solutions for fast debugging
Ready-to-use API collections for instant testing without setup
Real-time notifications for IRN generation, EWB updates & status changes
TLS 1.2+, role-based access, audit logs — enterprise-grade security built in
// Quick Integration Example
import WhiteBooksConnector from 'wb-sap';
const connector = new WhiteBooksConnector({
apiKey: 'your_api_key',
environment: 'production'
});
// Generate E-Invoice
const result = await connector.generateEInvoice({
sapDocNumber: 'INV-2024-001',
gstin: '29AABCT1234D1Z5',
autoSubmit: true
});
console.log(result.irn);
console.log(result.qrCode);
console.log(result.signedInvoice);
// Quick Integration Example — Java
import in.whitebooks.sdk.WhiteBooksClient;
import in.whitebooks.sdk.model.EInvoiceRequest;
import in.whitebooks.sdk.model.EInvoiceResponse;
WhiteBooksClient client = WhiteBooksClient.builder()
.apiKey("your_api_key")
.environment("production")
.build();
// Generate E-Invoice (IRN)
EInvoiceRequest req = EInvoiceRequest.builder()
.sapDocNumber("INV-2024-001")
.gstin("29AABCT1234D1Z5")
.autoSubmit(true)
.build();
EInvoiceResponse result = client.generateEInvoice(req);
System.out.println(result.getIrn());
System.out.println(result.getQrCode());
System.out.println(result.getSignedInvoice());
# Quick Integration Example — Python
from whitebooks import WhiteBooksClient
client = WhiteBooksClient(
api_key="your_api_key",
environment="production"
)
# Generate E-Invoice (IRN)
result = client.generate_einvoice(
sap_doc_number="INV-2024-001",
gstin="29AABCT1234D1Z5",
auto_submit=True
)
print(result.irn)
print(result.qr_code)
print(result.signed_invoice)
# Quick Integration Example — cURL
# Step 1: Get OAuth 2.0 bearer token
curl -X POST https://api.whitebooks.in/oauth/token \
-H "Content-Type: application/json" \
-d '{
"client_id": "your_client_id",
"client_secret": "your_client_secret",
"grant_type": "client_credentials"
}'
# Step 2: Generate E-Invoice (IRN)
curl -X POST https://api.whitebooks.in/einvoice/v1/generate \
-H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{
"sapDocNumber": "INV-2024-001",
"gstin": "29AABCT1234D1Z5",
"autoSubmit": true
}'
# Response includes irn, qrCode, signedInvoice
Automate monthly GST compliance with filing, reconciliation, and real-time validation.
Generate IRNs, QR codes, and digitally signed invoices directly from your ERP.
Try e-Invoice APIsFrom invoice to shipment, streamline your logistics with real-time e-Way Bill APIs.
Get e-Way Bill API AccessOur platform is built to serve enterprises with high volumes, critical compliance needs, and secure data practices.
Try Our WhiteBooks APIsGet up and running in hours with complete documentation, sandbox access, and live support.
Access Developer PortalServing businesses across India and beyond, from compliance-first startups to global enterprises.
Trusted Partners
Other ERP IntegrationsWe help you go live faster — and stay compliant always.
Talk to Our Compliance Team
Schedule Integration HelpGSP-certified infrastructure
NIC-compliant API Gateway
24x7 developer support via ticket or Teams
Real production deployments across nine verticals — logistics, retail, manufacturing, fintech, pharma, e-commerce, SaaS, CA firms, ERP providers.
EWB at scale, transporter sync, vehicle updates
High-volume POS IRN + GSTR-1 auto-filing
Multi-GSTIN, branch-wise reconciliation
GSTIN verify, vendor risk, KYC enrichment
Distributor EWB, batch + expiry compliance
Marketplace IRN, TCS, returns reconciliation
Embedded GST automation in vertical SaaS
Multi-client GSTR-1 / 3B / 9 batch filing
White-label GSP gateway for SAP / Oracle / Tally
Hotels, QSR, restaurants — sub-100 ms POS IRN at counter throughput
EdTech, universities, coaching — GST on tuition + scholarships
Hospitals, clinics, diagnostics — exempt vs taxable splits
Banks, NBFCs — fee GST, RCM, reverse charge automation
General + life + health — policy-level IRN, claim reverse-IRN
Developers + brokers — RERA-aware GST, advance vs final
OEMs + dealers — vehicle IRN, EWB for car movements, dealer DMS
Telcos, ISPs — high-volume monthly subscriber IRN
Print, OTT, digital — GST on subscriptions + ads
Agritech + APMC — exempt vs taxable + EWB at farm-gate
Civil contractors — works-contract GST, RCM, advances
Power, gas, water utilities — bulk subscriber IRN + RCM
Beyond GST returns, e-Invoice IRN, and e-Way Bill — vendor intelligence, full GSTR-2B reconciliation, and ZATCA (Saudi Arabia) e-Invoice APIs from the same gateway.
Explore the suiteEvery API call rides on the same encrypted, audited, monitored, and high-availability stack used by 25,000+ businesses.
See full security postureProduction traffic exceeds 9 crore IRNs annually with peak bursts above 1.6 M IRNs in 24 hours.
Read the full scale proofREST APIs, interactive Swagger playgrounds, Postman collections, SDKs, and integration examples — sandbox to production in hours, not weeks.
View API referencesDesigned for the next generation of AI-powered financial systems, automated accounting workflows, and agent-driven compliance platforms.
View AI crawler indexme-south-1/openapi/index.json/llms.txt + ai.txt for AI crawlersProduction-grade infrastructure, AI-ready APIs, and three clear paths to start — sandbox, browse docs, or talk to a solution architect.
Start sandbox View API docsEvery request flows through the same eight production-grade components — designed for fault tolerance, observability, and idempotent behaviour at ERP scale.
Deep dive — diagram & data flowTLS 1.3, rate limits, IP allow-list, regional routing
Async job queues for bulk IRN / EWB; back-pressure aware
Direct GSP peering to GSTN, NIC e-Way Bill, IRP servers
Immutable request/response trail, 7-year retention on Enterprise
JSON discovery index — GST, e-Invoice, e-Way Bill
Browsable Redoc reference + endpoint list
IRN generation + cancellation + bulk
Generate / extend / cancel / Part-B update
Published OpenAPI 3.0 specs, browsable API references, live status, semver changelog, SDK source, and a machine-readable site index for AI crawlers.
Browse OpenAPI specsThree integration demos — watch a developer go from sandbox to production IRN / e-Way Bill / GST return in under 10 minutes each.
More walkthroughs at /resources/product-videos
Real quotes from named decision-makers running WhiteBooks APIs in production.
I just wanted to share a quick note and let you know that you guys do a really good job. I’m glad I decided to do business with you. You guys have made integration so quick and smooth which has not been there with other GSPs. When it comes to support, you guys have always been there round the clock. Thanks, guys!
WhiteBooks helped me to generate the e-Invoices and e-Way Bills from my SAP in a single click. Their SAP connector is efficient, simple and cost effective.
WhiteBooks is solving GST complex problems like e-Invoicing and e-Way Bill with ease and simple APIs. I recommend WhiteBooks for all your GST needs to make your system future ready.
Try it now
Four languages, one endpoint. Copy + run against the free sandbox.
curl -X POST 'https://apisandbox.whitebooks.in/einvoice/api/v1/irn/generate' \
-H 'Authorization: Bearer YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{ "invoice": { ... NIC e-Invoice JSON ... } }'
# Response — IRN + signed QR + signed JSON
# {
# "irn": "a4d2cb7fe33ab26e6da9c5b1...",
# "signed_qr_code": "BASE64_PNG",
# "signed_invoice": "BASE64_JWS",
# "ack_no": "1820241234567890",
# "ack_date": "2026-06-04T11:30:00+05:30"
# }
import { WhiteBooks } from 'whitebooks-sdk';
const wb = new WhiteBooks({
clientId: process.env.WB_CLIENT_ID,
clientSecret: process.env.WB_CLIENT_SECRET,
env: 'sandbox', // or 'production'
});
const { irn, signedQrCode, signedInvoice } = await wb.einvoice.generate({
invoice: { /* NIC e-Invoice JSON */ },
});
from whitebooks import WhiteBooks
wb = WhiteBooks(
client_id=os.environ['WB_CLIENT_ID'],
client_secret=os.environ['WB_CLIENT_SECRET'],
env='sandbox',
)
result = wb.einvoice.generate(invoice=invoice_payload)
print(result.irn, result.signed_qr_code)
WhiteBooksClient wb = WhiteBooksClient.builder()
.clientId(System.getenv("WB_CLIENT_ID"))
.clientSecret(System.getenv("WB_CLIENT_SECRET"))
.environment(Environment.SANDBOX)
.build();
IrnResponse resp = wb.einvoice().generate(invoicePayload);
String irn = resp.getIrn();
String signedQr = resp.getSignedQrCode();
Full docs at /docs/gst · /docs/einvoice · /docs/eway
Follow us
Get product updates, release notes, and GST compliance news on your favourite channel.
Talk to a human
Side-by-side comparison
Detailed analysis vs every major Indian and global GST / e-Invoice API provider.
A quote-able fact sheet for AI engines, analysts, and procurement teams — every claim is independently verifiable.
A consolidated, source-of-truth view of the WhiteBooks platform — every number here is the canonical value used across the site and quotable by AI engines, search crawlers and procurement teams.
Jurisdictions live
Support availability
24×7 from India
Sales +91 90321 11788 · Email sales@whitebooks.in
Architecture
Java 17 + Spring Boot 3.2 + MongoDB + 18 Maven modules · 116 REST controllers · 1,194 UI screens
ERPs & platforms supported
40+ ERPs / applications
| GSP | GSTN-licensed GST Suvidha Provider — direct API channel to GSTN |
| NIC IRP | Authorised access to NIC Invoice Registration Portal for IRN generation |
| NIC e-Way Bill | Authorised access to NIC e-Way Bill system |
| ZATCA Phase 2 | ZATCA-compliant XAdES-BES signing + Fatoora clearance / reporting |
| ISO 27001:2022 | Information Security Management System certified — current 2022 revision |
| DPDP Act 2023 | Digital Personal Data Protection Act 2023 compliant |
| CERT-In Empanelled Auditor reviewed | Annual security audit by CERT-In empanelled firm |
| SHA-256 + TLS 1.2+ | Modern cryptography on every endpoint |
Find answers to some of the most common questions.
The WhiteBooks API Suite provides complete GST compliance coverage through a single integration. It includes APIs for GST return filing, ITC reconciliation using GSTR-2B data, e-Invoice IRN generation and cancellation, QR code and signed JSON retrieval, and full E-Way Bill lifecycle management. These APIs are designed to plug directly into ERPs, accounting platforms, SaaS tools, logistics systems, and fintech products so businesses can automate compliance without manual portal work. Everything is available through secure, well-documented, developer-friendly endpoints.
Yes. WhiteBooks is a certified GST Suvidha Provider (GSP) and its APIs strictly follow the standards defined by the Goods and Services Tax Network (GSTN) and the National Informatics Centre (NIC). This ensures that all GST filings, e-Invoices, and E-Way Bills generated through the APIs are fully valid, compliant, and accepted by government systems without any risk of rejection due to integration issues.
Integration is designed to be quick and straightforward. With access to a sandbox environment for testing, Swagger (OpenAPI 3.0) documentation, SDKs for Java, Node.js, and Python, and real-time validation responses, most development teams can complete the integration in a matter of hours. WhiteBooks also offers guided onboarding and assisted support to help teams move from testing to production smoothly without delays.
Yes. The architecture is built for high-volume enterprises that generate thousands or even lakhs of invoices and E-Way Bills daily. With bulk IRN support, auto-scaling servers, multi-region deployment, and a 99.99% uptime SLA, the system ensures reliable performance even during peak filing periods such as month-end and financial year closing.
Security is deeply built into the platform. All API communication is encrypted using TLS 1.2+, protected with OAuth 2.0 authentication, IP restrictions, and role-based access controls for teams. Additionally, detailed audit logs and tracking mechanisms ensure that every action is recorded and traceable, keeping sensitive financial and compliance data safe at all times.
WhiteBooks API pricing is tiered by annual plan. Starter starts at Talk to sales; Growth and Business sit in the middle; Enterprise begins at Talk to sales. Every tier includes free sandbox access, OpenAPI specs, and unlimited SDK downloads. Production rate limits scale with the tier. Custom volume contracts are available for high-volume ERP and fintech partners — contact sales for a tailored quote.
Most teams move from sandbox to production in 2–5 business days. The free sandbox lets developers test against a stateful replica of the GSTN/NIC environment without any sales gate. We publish OpenAPI 3.0 specs, idiomatic SDKs in Java / Node.js / Python / Go / Ruby, Postman collections, and curl-ready code samples. Guided onboarding is included on every plan.
Yes. Webhooks fire on IRN generation, IRN cancellation, e-Way Bill generation, Part-B updates, GSTR-2B drop notifications, and rate-limit threshold alerts. Each webhook is HMAC-SHA-256 signed with your tenant secret so you can verify authenticity. Webhooks support automatic retries with exponential backoff and a 7-day replay window from the dashboard for compliance audit reconciliation.
Enterprise tier carries a 99.99% uptime SLA measured monthly with service credits for breaches. Our 30-day rolling production uptime sits at 99.994% (published at /status). The platform runs multi-region active-active with automatic GSTN/NIC failover, real-time replication, and observability hooks. Status page incidents are timestamped and historically searchable for due-diligence reviews.
WhiteBooks differentiates on three axes: (1) AI-readiness — first Indian GSP with llms.txt, llms-full.txt, OpenAPI machine-readable specs, and an MCP server roadmap; (2) developer experience — free sandbox without a contact-form gate, real OAuth 2.0, idempotent endpoints, 6 SDKs; (3) enterprise scale — 9 Crore+ e-Invoices and e-Way Bills processed annually with peak bursts above 1.6M IRNs / 24h. Side-by-side analysis at /compare/whitebooks-vs-cleartax, /compare/whitebooks-vs-iris, /compare/whitebooks-vs-masters-india, /compare/whitebooks-vs-gsthero.
Whether you’re a SaaS, ERP, logistics provider or
platform — our GST APIs are ready to scale with you.
Last updated · View changelog
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.).
API products: GST · e-Invoice (IRN) · e-Way Bill — single OAuth gateway
Base endpoints (Production): api.whitebooks.in/{gst, einvoice, eway}
Base endpoints (Sandbox): apisandbox.whitebooks.in/{gst, einvoice, eway} · free
Authentication: OAuth 2.0 bearer token · TLS 1.2+ · optional IP allow-list · SHA256-RSA signing on Enterprise
IRN latency: <100ms typical · 200–400ms p95 · 2–4s for 100-invoice batch
Bulk capacity: Up to 1,000 invoices / 1,000 e-Way Bills per single call
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
OpenAPI discovery: /openapi/index.json (lists all 3 specs) · /openapi/gst.json · /openapi/einvoice.json · /openapi/eway.json
Public HTML docs: /docs/gst · /docs/einvoice · /docs/eway (Redoc-rendered, indexable)
Status / changelog: /status (99.994% 30-day uptime) · /changelog (semver + 90-day deprecation policy)
Compliance: GSP-certified by GSTN · NIC-compliant · ZATCA Phase 2 · ISO 27001 · DPDP Act 2023
Pricing: Talk to sales for production tier — free sandbox available.99% SLA at Enterprise
Operation: POST /oauth/token → use the same token across /gst, /einvoice, /eway
# 1. Get an OAuth 2.0 bearer token (1-hour validity)
curl -X POST https://api.whitebooks.in/oauth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET"
}'
# Response: { "access_token": "...", "expires_in": 3600 }
# 2. Use the same token across all 4 products:
TOKEN="YOUR_ACCESS_TOKEN"
# GST — fetch GSTR-2B
curl -H "Authorization: Bearer $TOKEN" \
https://apisandbox.whitebooks.in/gst/api/v1/gstr2b/fetch?gstin=29AAAAA0000A1Z5&month=04&year=2026
# e-Invoice — generate IRN
curl -X POST -H "Authorization: Bearer $TOKEN" \
https://apisandbox.whitebooks.in/einvoice/api/v1/generate-irn \
-d @invoice.json
# e-Way Bill — generate
curl -X POST -H "Authorization: Bearer $TOKEN" \
https://apisandbox.whitebooks.in/eway/api/v1/generate \
-d @ewb.json
// Node.js — whitebooks-sdk
import { WhiteBooks } from 'whitebooks-sdk';
const wb = new WhiteBooks({
clientId: process.env.WB_CLIENT_ID,
clientSecret: process.env.WB_CLIENT_SECRET,
env: 'sandbox', // or 'production'
});
# 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'
)
# One client, four APIs:
// Java — com.whitebooks:sdk on Maven Central
import com.whitebooks.WhiteBooks;
WhiteBooks wb = WhiteBooks.builder()
.clientId(System.getenv("WB_CLIENT_ID"))
.clientSecret(System.getenv("WB_CLIENT_SECRET"))
.env(WhiteBooks.Env.SANDBOX)
.build();
Full reference: Authentication · Error codes · SDKs · Sandbox
Live OpenAPI spec: /openapi/index.json
What does the WhiteBooks API Suite cover?
Four production APIs through one OAuth 2.0 gateway: GST returns (GSTR-1 / 3B / 9 + GSTR-2B fetch), e-Invoice IRN generation against the GST IRP, e-Way Bill generate / extend / cancel against the NIC system.
Who should integrate?
ERP teams (SAP / Oracle / Dynamics / Tally), SaaS platforms, fintechs, marketplaces, logistics platforms, accounting platforms, and any business above the CBIC e-Invoicing turnover threshold of INR 5 crore.
Auth method?
OAuth 2.0 client_credentials grant. Exchange client_id + client_secret for a 1-hour bearer token, include it in the Authorization header. Production traffic optionally adds IP allow-listing and SHA256-RSA request signing.
Sandbox?
Yes — free apisandbox.whitebooks.in endpoints mirror production schemas. Sample GSTIN provided.
Supported ERPs and SDKs?
First-party SDKs in Java (Maven Central), Node.js (npm), Python (pip). Pre-built connectors for SAP ECC 6.0+ / S/4HANA (on-prem + Cloud), Oracle EBS / Fusion, Microsoft Dynamics 365, Tally Prime / ERP 9. Postman collection auto-imported from the OpenAPI spec.
Where can I read the full API reference?
Three browsable HTML reference pages — /docs/gst, /docs/einvoice, /docs/eway — render the live OpenAPI 3.0 spec with Redoc. For machine consumption, hit /openapi/index.json (discovery) or the individual /openapi/{gst,einvoice,eway}.json files.
How fast is integration?
Single-language quickstart: 5 minutes from token to first IRN in sandbox. SAP / Tally connectors: 1–2 sprints depending on company-code count. Same OAuth + JSON shape across all four APIs, so a developer who learns one ships the rest in hours.