WhiteBooks APIs

The compliance infrastructure for India.

GSP-licensed APIs for GST, E-Invoice, and E-Way Bill. Trusted by 25,000+ businesses. 99.99% uptime SLA.

5-min quickstart

99.99%

Uptime SLA

184ms

Median latency

12.4M

Invoices / month

1	import WhiteBooks from '@whitebooks/node'
2
3	const client = new WhiteBooks({
4	apiKey: process.env.WB_API_KEY,
5	sandbox: false,
6	});
7
8	// Generate an e-invoice (IRN)
9	const irn = await client.einvoice.generate({
10	gstin: "29AAGCW7302R1ZF",
11	invoiceType: "B2B",
12	invoiceNumber: "INV-001",
13	invoiceDate: "2024-01-15",
14	});
15
16	console.log("IRN:", irn.irn)

200 OK·142ms

Every compliance API you need.

Four production-grade APIs, one developer experience, zero GSP complexity.

GST API

End-to-end GST compliance, returns filing, reconciliation, and ledger management via a single RESTful interface.

/gst/returns/gst/ledger/gst/reconcile

Explore

E-Way Bill API

Generate, extend, and cancel e-way bills programmatically with real-time GSTN sync.

/eway/generate/eway/extend/eway/cancel

Explore

E-Invoice API

IRN generation, signed QR codes, and bulk invoice management with GSP-grade reliability.

/einvoice/generate/einvoice/cancel/einvoice/bulk

Explore

1	// 1. Install the SDK
2	npm install @whitebooks/node
3
4	// 2. Initialize
5	const wb = new WhiteBooks({ apiKey })
6
7	// 3. Generate IRN
8	const result = await wb.einvoice.generate(payload)

1	{
2	"irn": "e9fc7b4b2c1a...",
3	"ackNo": 232410297398,
4	"ackDt": "2024-01-15T10:30:00",
5	"signedQRCode": "MSME/2024/...",
6	"status": "success"
7	}

From npm install to first IRN in 5 minutes.

Our SDK handles authentication, retries, and GSTN quirks so you can focus on your product. One API key, all compliance APIs.

SDKs for Node.js, Python, Go, Ruby, PHP, Java, and .NET

Built-in retry logic, idempotency keys, and error parsing

Sandbox environment with test GSTINs included

OpenAPI 3.1 spec + Postman collection included

Four steps to production.

STEP 01

Create account

$ npx create-wb-app my-project

2 min

STEP 02

Get API keys

Instantly generate sandbox and production API keys from the dashboard.

$ wb keys generate --env sandbox

< 1 min

STEP 03

Install SDK

Add our SDK to your project and configure your API key.

$ npm install @whitebooks/node

30 sec

STEP 04

Go live

Switch to production keys and handle real compliance workloads.

$ wb env use production

5 min

Free Forever · No Card

The sandbox is free — no credit card required.

Test GSTINs, mock GSTN responses, and full request logs — explore every API end to end before you ever pay a rupee.

API Keys

Manage your authentication credentials

Production — Main

liveAll APIsActive

Sandbox — Dev

sandboxE-Invoice onlyActive

CI/CD — Test

sandboxRead onlyExpiring

Platform Metrics

Last 90 days live production stats

99.991%

Uptime

90-day rolling

184ms

Median P50

API latency

12.4M

Invoices

This month

₹240Cr

Value processed

INR

Uptime: 60 daysOperational

Enterprise Security & Reliability

Enterprise-Grade Security
Built for Trust, Scale & Compliance

Every API call is protected by industry-leading security practices, continuous monitoring, and a high-availability infrastructure trusted by 25,000+ businesses.

WhiteBooks security — your data, protected, always

99.99% Uptime SLA

High availability you can depend on

TLS 1.2+ & OAuth2

Industry-standard encryption & secure authentication

Data Residency

Multi-region deployment for data sovereignty

Audit & Monitoring

Detailed logs & audit trails for complete visibility

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

Compliance & Accreditation Matrix

Licensed

GSP

GST Suvidha Provider — direct API channel to GSTN, no resold pipes

Authorised

NIC IRP

Invoice Registration Portal access for IRN generation

Authorised

NIC e-Way Bill

Direct access to the NIC e-Way Bill system

Certified

ISO 27001:2022

Information Security Management System — current 2022 revision

Audited annually

CERT-In Empanelled Auditor

Annual security audit by a CERT-In empanelled firm

Enforced

SHA-256 + TLS 1.2+

Modern cryptography enforced on every endpoint

Security is not just a feature—it's our foundation. WhiteBooks follows a security-first approach with regular audits, vulnerability assessments, and continuous improvements.

Developer Experience

Built for developers. Designed for speed.

Launch integrations in hours with SDKs, documentation, sandbox access and live diagnostics.

SDKs & languages

Node.js

Python

Access Developer Portal

POST /v1/invoices

curl https://api.whitebooks.in/v1/invoices \
 -H "Authorization: Bearer ••••" \
 -d { "gstin": "29ABCDE1234F1Z5" }

{
  "status": "success",
  "irn": "a1b2c3…"
}

200 OK · 142ms · IRN generated

OpenAPI specs

Swagger / OpenAPI 3.0

SDK support

First-class client libraries

Sandbox validation

Real-time test environment

Versioned APIs

Backward-compatible releases

Error diagnostics

Smart codes + debugging hints

Usage monitoring

Live dashboard for usage & issues

Integrations

Connect WhiteBooks with your existing ecosystem

Integrate with ERPs, accounting software, POS systems and custom applications.

Trusted Partners

WhiteBooks Integration Layer

GST APIs

eInvoice APIs

eWay Bill APIs

ERP Systems

POS Platforms

Accounting Software

Custom Apps

Marketplace Platforms

Explore Integrations

Compliance & Support

Enterprise-grade API infrastructure backed by experts

Go live faster with certified GST, e-Invoice, e-Way Bill and Notice Management APIs, guided onboarding and support designed for scale.

Schedule Integration Help

GSP-licensed infrastructure

Direct GSTN-licensed gateway

NIC-compliant API gateway

Aligned with NIC standards

Guided onboarding & assisted integration

Hands-on go-live support

Dedicated enterprise success team

Named account ownership

24×7 technical support

Ticket or Teams, always on

Request

Inbound API call

GST Gateway

WhiteBooks GSP

NIC

Government network

Success

Signed & returned

Infrastructure

Free Sandbox Forever · No Card

Test everything before going live.

Full sandbox with pre-loaded test GSTINs, mock GSTN responses, and configurable error scenarios.

Test GSTINs with realistic GSTN data

Trigger 4xx and 5xx error scenarios

Inspect full request / response logs

No rate limits in sandbox

Sandbox liveRequest log

Time	Method	Path	Status	ms
10:31:04	POST	/v3/einvoice/generate	200	142
10:31:02	GET	/v3/gst/returns?gstin=29AAG...	200	89
10:30:58	POST	/v3/eway/generate	200	213
10:30:55	GET	/v3/einvoice/29AAG.../INV-001	404	34
10:30:51	PUT	/v3/eway/INV-001/part-b	200	178
10:30:44	DELETE	/v3/einvoice/cancel/IRN-007	200	98
10:30:35	GET	/v3/gst/ledger?period=2024-01	200	67

APIs for every compliance-driven industry.

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

Logistics

EWB at scale, transporter sync, vehicle updates

Retail

High-volume POS IRN + GSTR-1 auto-filing

Manufacturing

Multi-GSTIN, branch-wise reconciliation

Fintech

GSTIN verify, vendor risk, KYC enrichment

Pharma

Distributor EWB, batch + expiry compliance

E-Commerce

Marketplace IRN, TCS, returns reconciliation

SaaS

Embedded GST automation in vertical SaaS

CA Firms

Multi-client GSTR-1 / 3B / 9 batch filing

ERP Providers

White-label GSP gateway for SAP / Oracle / Tally

Hospitality

Hotels and QSRs — IRN workflows for point-of-sale operations

Healthcare

Hospitals, clinics — exempt vs taxable splits

Banking

Banks, NBFCs — fee GST, RCM automation

Insurance

Policy-level IRN, claim reverse-IRN

Real Estate

Developers + brokers — RERA-aware GST

Automotive

OEMs + dealers — vehicle IRN, EWB, dealer DMS

Telecom

Telcos, ISPs — high-volume monthly subscriber IRN

Media

Print, OTT, digital — GST on subscriptions + ads

Energy & Utilities

Power, gas, water — bulk subscriber IRN + RCM

Browse all use cases

Ship compliance at infrastructure speed.

Join 3,000+ businesses using WhiteBooks APIs to automate their compliance workflows. Free sandbox, no credit card required.

The compliance infrastructure for India.

Every compliance API you need.

GST API

E-Way Bill API

E-Invoice API

From npm install to first IRN in 5 minutes.

Four steps to production.

Create account

Get API keys

Install SDK

Go live

The sandbox is free — no credit card required.

API Keys

Platform Metrics

Enterprise-Grade SecurityBuilt for Trust, Scale & Compliance

Infrastructure Highlights

Compliance & Accreditation Matrix

GSP

NIC IRP

NIC e-Way Bill

ISO 27001:2022

CERT-In Empanelled Auditor

SHA-256 + TLS 1.2+

Built for developers. Designed for speed.

OpenAPI specs

SDK support

Sandbox validation

Versioned APIs

Error diagnostics

Usage monitoring

Connect WhiteBooks with your existing ecosystem

WhiteBooks Integration Layer

Enterprise-grade API infrastructure backed by experts

GSP-licensed infrastructure

NIC-compliant API gateway

Guided onboarding & assisted integration

Dedicated enterprise success team

24×7 technical support

Test everything before going live.

APIs for every compliance-driven industry.

Ship compliance at infrastructure speed.

Enterprise-Grade Security
Built for Trust, Scale & Compliance