WhiteBooks API Changelog
Versioned release notes for the WhiteBooks GST, e-Invoice, e-Way Bill, and KSA ZATCA APIs — plus SDK updates, breaking changes, and deprecation timelines. We follow semver: breaking changes only on major bumps, with at least 90 days' deprecation notice.
Subscribe via RSS · machine-readable index · live status
v3.2.0
New Public OpenAPI 3.0 specs at stable URLs:
https://whitebooks.in/openapi/gst.json(GSTR-1/3B/9 + 2B + GSTIN verify)https://whitebooks.in/openapi/einvoice.json(IRN gen + cancel + bulk)https://whitebooks.in/openapi/eway.json(EWB gen + extend + cancel)https://whitebooks.in/openapi/index.json(discovery)https://whitebooks.in/openapi.json(canonical alias ofgst.json)
New Quick Facts + tabbed code examples (cURL / Node.js / Python / Java) on every /api/* page.
New Comparison pages: vs Masters India, vs ClearTax, vs Sandbox (Quicko).
New Tally + GST integration use-case with HowTo schema.
New Public status page with 30/90-day uptime + incident history.
New On-page tiered pricing table with Starter / Growth / Business / Enterprise plans.
v3.1.2
Fix e-Invoice API: corrected p95 latency regression introduced in v3.1.1 (IRP routing path normalization). p95 IRN response time is back below 350 ms.
Security Rotated GSP gateway TLS certificates (zero-downtime). All clients using TLS 1.2+ are unaffected.
Fix e-Way Bill: improved retry logic for NIC API transient 5xx — now retries with 1s / 2s / 4s exponential backoff before surfacing as HTTP 502.
v3.1.1
New SDK releases:
whitebooks-sdk@3.1.1on npm (Node.js 18+ LTS)whitebooks==3.1.1on PyPI (Python 3.10+)com.whitebooks:sdk:3.1.1on Maven Central (Java 11+)
New Webhook callback support for asynchronous bulk IRN: POST your registered webhook URL when each batch completes.
Fix KSA ZATCA: corrected XAdES-BES signature canonicalization edge case for invoices with non-ASCII line-item descriptions.
v3.1.0
New KSA ZATCA Phase-2 reporting mode (simplified tax invoices) endpoint: POST /ksa-einvoice/api/v1/reporting. Standard tax invoice clearance remains at POST /ksa-einvoice/api/v1/clearance.
New Bulk e-Way Bill: POST /eway/api/v1/bulk-generate accepts up to 1,000 EWBs per call with per-row status reporting.
Deprecated POST /gst/api/v1/legacy-gstr2b — remove by 1 July 2026. Use POST /gst/api/v1/gstr2b/fetch (same response shape).
v3.0.0 — major
Breaking Token expiry shortened from 24h to 1 hour; clients must refresh tokens. The Java / Node / Python SDKs handle refresh automatically — only custom REST clients need to be updated.
New OAuth 2.0 client credentials grant on all endpoints (was: API-key on a subset).
New Optional IP allow-listing on Production for all plans (was: Enterprise only).
New Optional SHA256-RSA request signing on Enterprise.
Security ISO 27001 surveillance audit passed; DPDP Act 2023 compliance attestation published.
v2.9.0
New GSTR-9C (reconciliation statement) filing endpoint.
New HSN/SAC code search endpoint: GET /gst/api/v1/hsn-sac/search?q=....
Fix Bulk IRN: corrected race condition that could double-cancel an IRN if the cancel request arrived within 50 ms of generation.
v2.8.0
New Microsoft Dynamics 365 Business Central connector (BCE app on AppSource).
New Webhook signature verification documented at #security.
v2.7.0
New Oracle EBS / Fusion connector (general availability).
New SAP S/4HANA Cloud (Public + Private) connector via OData / SCP.
Fix Improved p99 latency for high-cardinality GSTR-1 uploads (10,000+ line items).
v2.6.0
New Consolidated e-Way Bill endpoint: POST /eway/api/v1/consolidated for transporter-led consolidations.
New Postman collection auto-imported from OpenAPI 3.0 spec.
Deprecation policy
We commit to a 90-day minimum deprecation window for any endpoint, field, or behaviour we remove. Deprecation is announced here, in the response headers (Deprecation: true, Sunset: <date>), and via email to all account owners. Breaking changes only ship on major version bumps; minor and patch releases are always backwards-compatible.
Versioning
Follows semver:
- Major (e.g.
v3.0.0): breaking changes. Old major versions supported for 12 months. - Minor (e.g.
v3.1.0): new endpoints, fields, behaviours. Backwards-compatible. - Patch (e.g.
v3.1.2): bug fixes, security patches, performance improvements.