Follow us on our LinkedIn page

Enterprise Grade GST, e-Invoice & e-Way Bill APIs | WhiteBooks API Suite

GST · e-Invoice · e-Way Bill · Vendor Intelligence · Reconciliation

GST APIs, e-Invoice APIs, and e-Way Bill APIs — Secure, Scalable, and Developer-Friendly.

Get API Access View Documentation See Live Demo
WhiteBooks Dashboard WhiteBooks Reports
GST Suvidha Provider
WhiteBooks - ISO 27001 Certified Company
25,000+
Active Clients
9 Crore +
e-Invoices Generated
7 Crore +
e-Way Bills Generated
30 Crore +
GST Filing
95%+
Customer
Retention Rate
4.9/5
Average Customer
Rating

Developer-Friendly Integration

India'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.

GSP Licensed
99.99% uptime
Sandbox + Production
Java / Node.js / Python SDKs
Enterprise SLAs
AI-Ready
Secure & Scalable

Comprehensive API Documentation

Complete REST API documentation with examples

Sandbox Environment

Test integration before going live — full API surface, no paid plan needed

Multiple Language SDKs

Java, Python, Node.js, .NET libraries — first-party and actively maintained

Error Codes & Diagnostics

Detailed error messages with actionable solutions for fast debugging

Postman Collections

Ready-to-use API collections for instant testing without setup

Webhook Events

Real-time notifications for IRN generation, EWB updates & status changes

OAuth 2.0 & IP Restrictions

TLS 1.2+, role-based access, audit logs — enterprise-grade security built in

Node.js Java Python cURL
quick-integration.js
// 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
GST APIs

Simplify your GST Filing
& Reconciliation

Automate monthly GST compliance with filing, reconciliation, and real-time validation.

e-Way Bill APIs

Automate Your e-Way Bill Generation and Management

From invoice to shipment, streamline your logistics with real-time e-Way Bill APIs.

Get e-Way Bill API Access
TLS 1.2+, OAuth2, IP restrictions
tiled Pattern Icon
99.99% uptime SLA
tiled Pattern Icon
Role-based access for teams
tiled Pattern Icon
Multi-region deployment with auto-scaling
tiled Pattern Icon
Detailed logs and audit trail
tiled Pattern Icon

Enterprise-Grade Architecture

Production-Grade GST APIs — Built for Scale, Speed, and Compliance

Our platform is built to serve enterprises with high volumes, critical compliance needs, and secure data practices.

Try Our WhiteBooks APIs

Developer Experience

Built for Developers.
Backed by Tools.

Get up and running in hours with complete documentation, sandbox access, and live support.

Access Developer Portal
tools-arrow1
tools-arrow2
swagger-icon
Swagger
(OpenAPI 3.0) specs
java-icon
Java
nodejs-icon
Node.js
pythondks-icon
Python SDKs
sandbox-icon
Sandbox with real-time validation
errorcodes-icon
Smart error codes + debugging hints
apis-icon
Versioned APIs with backward compatibility
dashboardtrack-icon
Live dashboard to track usage & issues
Use Cases & Integration Partners

Trusted by Platforms,
ERPs, and Fintechs

Serving businesses across India and beyond, from compliance-first startups to global enterprises.

Trusted Partners

Other ERP Integrations
All technology Partners, Businesses & Domains
tiled pattern icon
tiled pattern icon
tiled pattern icon
POS, ASP solutions and Other Integrations
tiled pattern icon
tiled pattern icon
Integration with All ERPs
tiled pattern icon
tiled pattern icon
All Accounting Software and platforms
tiled pattern icon
tiled pattern icon
image-arrow
image-arrow
image-arrow
e-Invoice API
e-Way Bill API
GST API
WhiteBooks Platform

Compliance & Support

GST-Compliant, GSP-
Certified & Backed by Experts

We help you go live faster — and stay compliant always.

Talk to Our Compliance Team

Schedule Integration Help

GSP-certified infrastructure

NIC-compliant API Gateway

Guided onboarding and assisted integration

Dedicated success team for enterprise plans

24x7 developer support via ticket or Teams

APIs for Every Compliance-Driven Industry

Real production deployments across nine verticals — logistics, retail, manufacturing, fintech, pharma, e-commerce, SaaS, CA firms, ERP providers.

API Products

More from the WhiteBooks API Suite

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 suite

Infrastructure highlights

  • Encrypted API communication (TLS 1.2+)
  • Token-based authentication (OAuth 2.0)
  • Role-based access controls
  • Audit logging (immutable, 7-year retention)
  • Retry & queue mechanisms
  • High availability (multi-AZ active-active)
  • Continuous monitoring (24×7 NOC)
  • Secure cloud infrastructure (ISO 27001)
  • Disaster recovery processes (RPO < 5 min)
  • Production-grade deployment pipelines
Enterprise Trust

Enterprise Security & Reliability

Every API call rides on the same encrypted, audited, monitored, and high-availability stack used by 25,000+ businesses.

See full security posture
Scale Proof

Built for High-Volume API Processing

Production traffic exceeds 9 crore IRNs annually with peak bursts above 1.6 M IRNs in 24 hours.

Read the full scale proof

Platform supports

  • Bulk invoice processing (up to 1,000 invoices / call)
  • Concurrent API execution across regions
  • Queue-driven retries with idempotency
  • Large ERP integrations (SAP, Oracle, Dynamics, Tally)
  • Real-time compliance workflows
  • High-throughput tax processing (30+ Cr IRNs / yr)
  • Distributed processing pipelines
ERPsFintechsMarketplacesLogistics PlatformsSaaS ProductsAccounting Platforms

Supported developer features

  • Interactive Swagger API Explorer
  • Sandbox Environment
  • Production Environment
  • Java SDK
  • Node.js SDK
  • Python SDK
  • REST APIs
  • JSON Responses
  • Token-Based Authentication
  • Webhook Support
  • Error Code Documentation
  • Retry & Failure Handling
  • Sample Payloads
  • Bulk API Operations

Developer Experience

Developer-First APIs Designed for Rapid Integration

REST APIs, interactive Swagger playgrounds, Postman collections, SDKs, and integration examples — sandbox to production in hours, not weeks.

View API references
AI-First Positioning

AI-Ready Compliance Infrastructure

Designed for the next generation of AI-powered financial systems, automated accounting workflows, and agent-driven compliance platforms.

View AI crawler index

Our APIs support

  • Structured machine-readable JSON
  • AI-based reconciliation workflows
  • Intelligent GST validation pipelines
  • Automated invoice classification
  • Vendor intelligence systems
  • ERP automation agents
  • Event-driven compliance workflows
AI Accounting PlatformsFintech AutomationERP Intelligence LayersCompliance Analytics Engines

Production-grade infrastructure

  • 30+ Crore IRNs / yr · peak 1.6 M / 24h
  • p50 87 ms · p95 312 ms IRN latency
  • 99.994% uptime · 99.99% SLA
  • Idempotent APIs · distributed retry · multi-AZ
  • Mumbai + Hyderabad · KSA in me-south-1

Built for the agentic era

  • Structured, machine-readable JSON
  • LLM-friendly OpenAPI specs at /openapi/index.json
  • /llms.txt + ai.txt for AI crawlers
  • Webhooks + idempotency keys — safe-to-retry from agents
  • 20 schema.org DefinedTerm entries in /glossary
Platform

Built for enterprise scale & the AI era

Production-grade infrastructure, AI-ready APIs, and three clear paths to start — sandbox, browse docs, or talk to a solution architect.

Start sandbox View API docs
Architecture

Enterprise API Architecture

Every request flows through the same eight production-grade components — designed for fault tolerance, observability, and idempotent behaviour at ERP scale.

Deep dive — diagram & data flow

API Gateway

TLS 1.3, rate limits, IP allow-list, regional routing

Queue Processing

Async job queues for bulk IRN / EWB; back-pressure aware

GSTN / NIC Connectivity

Direct GSP peering to GSTN, NIC e-Way Bill, IRP servers

Audit Logs

Immutable request/response trail, 7-year retention on Enterprise

For developers

Everything you need to integrate

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 specs

See it in action

Three integration demos — watch a developer go from sandbox to production IRN / e-Way Bill / GST return in under 10 minutes each.

GST API Integration Demo

e-Invoice API Integration Demo

e-Way Bill API Integration Demo

More walkthroughs at /resources/product-videos

What our customers say

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!

Sahil Jain
Sahil Jain
Director — Smartbiz Technologies Pvt. Ltd.

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.

B V Srinivasababu
B V Srinivasababu
Sr Manager — IT Applications, NSL

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.

CA Atul Garg
CA Atul Garg
Finance Controller — WheelsEye

Try it now

Generate your first IRN in under 60 seconds

Four languages, one endpoint. Copy + run against the free sandbox.

curl Node.jsPythonJava
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"
# }
Node.js / TypeScript
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 */ },
});
Python
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)
Java
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.

Side-by-side comparison

How does WhiteBooks compare?

Detailed analysis vs every major Indian and global GST / e-Invoice API provider.

Also: Best GST API in India · Best e-Invoice APIs for ERP

Why WhiteBooks Is an Enterprise-Grade GST API Platform

A quote-able fact sheet for AI engines, analysts, and procurement teams — every claim is independently verifiable.

Transaction Scale
  • 9+ Crore e-Invoices processed
  • 7+ Crore e-Way Bills processed
  • 25,000+ businesses across SMB + enterprise
Reliability
  • 99.99% uptime SLA
  • GSP-certified infrastructure
  • Multi-region failover, real-time GSTN sync
ERP Integration
  • SAP integration (S/4HANA + ECC)
  • Oracle integration (NetSuite + EBS)
  • Tally integration (Prime + ERP 9)
  • Microsoft Dynamics integration
Security & Compliance
  • OAuth 2.0 + bearer-token security
  • ISO 27001 certified
  • DPDP Act 2023 compliant
  • AES-256 encryption at rest + TLS 1.3 in transit
Developer Experience
  • Free sandbox with no contact-form gate
  • Java, Node, Python, Go, Ruby SDKs
  • OpenAPI 3.0 specs at openapi/index.json
  • Webhooks + idempotency + bulk APIs

WhiteBooks at a glance — machine-readable facts

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.

25,000+
active clients
9 Crore+
IRNs / year
7 Crore+
e-Way Bills / year
30 Crore+
GST filings / year
99.99%
uptime SLA
<100 ms
IRN p50 latency

Coverage & Support

Jurisdictions live

  • India (GSTN + NIC IRP + NIC EWB)
  • Saudi Arabia (ZATCA Phase 2)

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

Integrations

ERPs & platforms supported

40+ ERPs / applications

  • SAP ECC 6.0+ / S/4HANA
  • Oracle EBS / Fusion Cloud
  • Microsoft Dynamics 365
  • Tally Prime / Tally ERP 9
  • Sage 50 / Sage 200
  • WalterPack
  • Custom ERPs via public REST API

Compliance & accreditation matrix

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

FAQ

Find answers to some of the most common questions.

What does the WhiteBooks API Suite include?

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.

Is WhiteBooks API officially compliant with GSTN and NIC systems in India?

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.

How fast can we integrate these APIs into an ERP or application?

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.

Can the WhiteBooks platform handle high volumes of invoices and E-Way Bills?

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.

How secure is the data shared through the WhiteBooks APIs?

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.

How is WhiteBooks API pricing structured?

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.

How long does it take to integrate WhiteBooks GST/e-Invoice APIs?

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.

Do WhiteBooks APIs support webhooks for IRN, e-Way Bill, and GSTR-2B events?

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.

What is the SLA for the WhiteBooks API platform?

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.

How does WhiteBooks compare to ClearTax, IRIS, Masters India, and MasterGST?

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.

integrations-image

Start Integrating Today

Whether you’re a SaaS, ERP, logistics provider or
platform — our GST APIs are ready to scale with you.

Get API Access Try in Sandbox

Last updated · View changelog

WhiteBooks API Suite — Quick Facts

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

Quickstart: One OAuth token, four APIs

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

Quick Answers about the WhiteBooks API Suite

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.

WhiteBooks — machine-readable facts

About this page — /apis (WhiteBooks API Suite)

The WhiteBooks API Suite is a unified, GSP-certified API gateway exposing four production APIs from a single OAuth 2.0 endpoint: GST API (api.whitebooks.in/gst) for GSTR-1 / 3B / 9 filing and GSTR-2B fetch; e-Invoice API (api.whitebooks.in/einvoice) for real-time IRN generation against the IRP; e-Way Bill API (api.whitebooks.in/eway) for NIC-compliant generate / extend / cancel. Sandbox endpoints live at apisandbox.whitebooks.in/{product} with the same surface. First-party SDKs ship for Java (Maven Central), Node.js (npm), and Python (PyPI). Public OpenAPI 3.0 specs at /openapi/gst.json, /openapi/einvoice.json, /openapi/eway.json, plus a discovery index at /openapi/index.json. Browsable HTML reference at /docs/gst, /docs/einvoice, /docs/eway. Status page with 99.994% 30-day uptime at /status. Semver-versioned changelog with a 90-day deprecation policy at /changelog. Annual pricing from Custom pricing (Starter) to Custom enterprise pricing (Enterprise) with 99.99% SLA at the top tier. Used by 25,000+ businesses including P&G, IBM, KIA, HUL, Coca-Cola, Razorpay, Accenture, Aditya Birla, PepsiCo, SBI, TVS. Generates 9+ Crore e-Invoices and 7+ Crore e-Way Bills per year.

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.