The WhiteBooks API suite
Four production REST APIs — including our GST API — over a directly GSTN-licensed GSP channel. Pick an API to browse every endpoint with request and response schemas, code samples, and a live playground.
REST API for GST return filing (GSTR-1, 3B, 9), GSTIN validation, GSTR-2A/2B retrieval, and HSN/SAC search — over a directly GSTN-licensed GSP channel.
Generate, cancel, and fetch IRNs on India’s Invoice Registration Portal with sub-200ms p50 latency. Single and bulk operations over a direct GSP pipe.
Create and manage e-way bills against the NIC system, auto-populate from an IRN, and run bulk operations — with retry-safe transient error handling.
Base URLs
https://apisandbox.whitebooks.inhttps://api.whitebooks.inEvery request is authenticated with an OAuth 2.0 bearer token plus your x-api-key. New here? Start with the Quickstart.
Authentication
OAuth 2.0 tokens, refresh, and production security controls.
All endpoints
Every operation across the API suite, grouped by API and resource.
REST API for GST return filing (GSTR-1, 3B, 9), GSTIN validation, GSTR-2A/2B retrieval, and HSN/SAC search — over a directly GSTN-licensed GSP channel.
Public
Authentication
GSTR1
- GETGet GSTR1 Summary
- GETGet GSTR1 Document Issued
- GETGet CDNRA Invoices
- GETGet B2CL Invoices
- GETGet B2BA Invoices
- GETGet ATA
- GETGet TXP
- GETGet Supplier ECO invoices
- GETGet Supplier ECOA invoices
- GETGet ECOM Invoices
- GETGet ECOMA Invoices
- PUTSave GSTR1 data
- GETGet B2B Invoices
- GETGet B2CLA Invoices
- GETGet B2CSA Invoices
- GETGet CDNR Invoices
- GETGet AT
- GETGet EXPA
- GETGet B2CS Invoices
- GETGet EXP
- GETGet Nil Rated Supplies
- GETGet HSN Summary details
- GETValidate the HSN Summary details
- GETAPI call for getting all Credit/ Debit Notes issued to un-registered persons for a return period.
- GETAPI call for getting all amended Credit/ Debit Notes issued to un-registered persons for a return period.
- POSTReset GSTR1 Data
- POSTFile GSTR1 data
- POSTFile GSTR1 data
- GETGet TXPA
- GETGet E-Invoices
GSTR1A
- GETGet GSTR1A Summary
- GETGet GSTR1A Document Issued
- GETGet CDNRA Invoices
- GETGet B2CL Invoices
- GETGet B2BA Invoices
- GETGet ATA
- GETGet TXP
- GETGet Supplier ECO invoices
- GETGet Supplier ECOA invoices
- GETGet ECOM Invoices
- GETGet ECOMA Invoices
- PUTSave GSTR1A data
- GETGet B2B Invoices
- GETGet B2CLA Invoices
- GETGet B2CSA Invoices
- GETGet CDNR Invoices
- GETGet AT
- GETGet EXPA
- GETGet B2CS Invoices
- GETGet EXP
- GETGet Nil Rated Supplies
- GETGet HSN Summary details
- GETAPI call for getting all Credit/ Debit Notes issued to un-registered persons for a return period.
- GETAPI call for getting all amended Credit/ Debit Notes issued to un-registered persons for a return period.
- POSTReset GSTR1A Data
- POSTFile GSTR1A data
- POSTFile GSTR1A data
- GETProceed To File
- GETGet TXPA
GSTR2A
GSTR3B
- GETGet GSTR3B Summary
- GETGet GSTR1 auto calculated liability details
- PUTSave GSTR3B data
- PUTOffset Liability GSTR3B Data
- PUTSave past liability breakup GSTR3B Data
- POSTFile GSTR3B data
- POSTFile GSTR3B data
- POSTvalidate GSTR3B against auto calculated values
- POSTRecompute System Calulated Interest
- GETGet system calculated interest
- GETGet ITC Reversal Balance
- GETGet Opening Balance For Credit Reversal and Re-claimed Details
- GETGet latest closing balance
- GETGet RCM opening balance
- POSTSubmit RCM opening balance
GSTR4
- PUTSave GSTR4 data
- GETGet B2B Invoices
- GETGet B2B Unregistered Invoice
- GETGet IMPS
- GETGet CDNR Invoices
- GETAPI call for getting all Credit/ Debit Notes issued to un-registered persons for a return period.
- GETAPI call for getting invoices for Tax on Outward Supplies for a return period.
- GETGet AT
- GETGet TXP
- GETGet GSTR1 Summary
- POSTSubmit GSTR4 data
- GETGet TDS
- POSTFile GSTR4 data
- POSTFile GSTR4 data
- POSTAPI call for offsetting the liabilities and interest from GSTR4
- GETGet B2BA Invoices
- GETGet B2BUR Amendment
- GETGet Imports of Services Amendment
- GETGet CDNR Amendment
- GETGet CDNUR Amendment
- GETGet TXOS Amendment
- GETGet Advances Paid Amendment
- GETGet Advances Adjusted Amendment
GSTR4Annual
- PUTSave GSTR4Annual data
- GETGet tdscmp Invoices
- GETGet txios Invoices
- GETGet validate turnover for GSTR4 Annual form
- GETGet validate the liability provided in table 6 for GSTR4 Annual form
- GETGet autopopulated data for table 4A/4B of GSTR4 Annual form
- GETGet summary Invoices
- POSTFile GSTR4Annual data
- POSTFile GSTR4 Annual data
GSTR5
- GETGet B2B Invoices
- GETGet B2BA Invoices
- GETGet CDNR Invoices
- GETGet CDNRA Invoices
- GETGet IMPG Invoices
- GETGet IMPGA Invoices
- GETGet IMPS Invoices
- GETGet IMPSA Invoices
- PUTSave GSTR5 data
- GETGet CDNA Unregistered
- GETGet GSTR5 Summary
- POSTSubmit
- POSTFile GSTR5
- POSTFile GSTR5 data
- GETGet B2CL Invoices
- GETGet B2CS Invoices
- GETGet CDN Unregistered
- GETGet Tax Liab
- PUT Offset Liability GSTR5 data
- GETGet B2CLA Invoices
- GETGet B2CSA Invoices
GSTR6
- GETGet B2B Invoices
- POSTGSTR6 Calculate R6
- POSTSave GSTR6 Cross ITC details
- PUT Offset Liability GSTR6 Late fee
- PUTSave GSTR6 data
- GETGet CDNR Invoices
- GETGet ISD Details
- GETGet GSTR6 Summary
- POSTSubmit GSTR6 data
- POSTFile GSTR6 data
- POSTFile GSTR6 data
- GETGet Late Fee
- GETGet ITC Details
- GETGet B2BA Invoices
- GETGet CDNRA Invoices
- GETGet Amendment ISD Details
GSTR7
GSTR8
GSTR9
GSTR9A
GSTR9C
SPIKE
ALL
IMS
ITC03
ITC04
Ledger
e-Invoice
Generate, cancel, and fetch IRNs on India’s Invoice Registration Portal with sub-200ms p50 latency. Single and bulk operations over a direct GSP pipe.
Authentication
Get GSTN Details
Get Sync GSTIN From CP
Generate IRN
Get EInvoice Details
Get IRN details by Doc Details
Cancel IRN
Get Rejected IRNs
Generate Ewaybill
Get Ewaybill Details by IRN
Get B2C QR Code Details
Create and manage e-way bills against the NIC system, auto-populate from an IRN, and run bulk operations — with retry-safe transient error handling.