GST APIs for
Modern Developers
The WhiteBooks GST API gives developers programmatic access to GSTR-1 / GSTR-3B / GSTR-9 filing, GSTR-2B fetch, GSTIN verification, and HSN/SAC lookup through the certified GSP channel to the GSTN.
Architecture
WhiteBooks sits between your application and GSTN, providing a reliable, GSP-licensed relay layer.
How To Start
Follow these steps to get started with the GST API integration.
Register for a GSTIN sandbox account. Please select GSP as "BVM IT Consulting Services India Pvt Ltd". Click Here
Create your WhiteBooks developer account to access API credentials and the sandbox environment. Sign up
Login → Under GST API → Click on Buy Now to purchase Sandbox.
Once you receive Sandbox Details from GSTIN, use your GSTIN Username & GSTIN Number along with WhiteBooks API Credentials.
Join the GST Suvidha Provider discussion group for API support and community help. Click Here
Access official GSTIN API Payload and Documentation for detailed integration guides. Click Here
Sandbox API
Default OTP for GSTR1 authentication in sandbox is 575757
WhiteBooks GST API Sandbox Information
To use GST API Sandbox Credentials, follow the steps below to generate your API keys from the developer dashboard.
Click "Credentials" on the GST API card, then click "Create Credentials" button.
Fill in the required details in the popup and submit to receive your API keys.
Jump Into the API
Pick a category to land straight on the endpoint reference — request schemas, parameters, and live code examples included.
Best Practices
Follow these patterns for production-grade, maintainable GST integrations.
Always validate integration against the sandbox environment. The sandbox mirrors production schema exactly. No surprises at go-live.
Set BASE_URL=https://api.sandbox.whitebooks.in/Access tokens expire after 3600 seconds. Implement automatic token refresh logic before expiry to avoid 401 errors mid-session.
if (token.expires_in < 300) refreshToken()Use the /validate endpoint before submission to catch GSTIN mismatches, invalid HSN codes, and tax computation errors upfront.
POST /api/v2/invoices/validateStore all API request/response payloads with timestamps for compliance audit trails. Include IRN and ACK numbers in your records.
Log: irn, ack_no, timestamp, gstinSDKs & Libraries
Integrate seamlessly with our collection of high-performance client libraries. Built for stability and optimized for developer productivity across your stack.
Download and unzip the file and open it with the related application.Please Login/Sign up to download the files.
Developer Resources & Documentation
Everything you need to integrate the GST APIs — certificates, reference docs, help guides, and error codes.
Frequently Asked Questions
Scale GST Compliance with Powerful APIs
Integrate WhiteBooks GST APIs into your ERP, accounting software, fintech platform, or SaaS application to automate GST filing, GSTIN verification, reconciliation, invoicing, and tax compliance workflows with scalable production-ready APIs.