Quickstart
Go from zero to your first authenticated API call in about five minutes. Everything here runs against the free sandbox — no credit card, no production data.
Make your first request
After signing up, open your dashboard and copy your x-api-key, client_id, and client_secret. These identify your application against the sandbox.
All sandbox requests go to https://apisandbox.whitebooks.in. Endpoints are mounted under their respective service routes (such as /public/search or /einvoice/...). Switch to https://api.whitebooks.in when you go live.
WhiteBooks uses OAuth 2.0. Call the authentication endpoint to receive a short-lived bearer token (valid for one hour).
The response contains the token you’ll attach to every subsequent request:
Send the token as a Bearer header. This example validates a GSTIN using the GST API:
When your integration is ready, swap the base URL to https://api.whitebooks.in and use your production credentials. Tokens, headers, and payloads stay identical.
Environments
| Environment | Base URL | Notes |
|---|---|---|
| Sandbox | https://apisandbox.whitebooks.in | Free. Test data only. 60 requests/min. |
| Production | https://api.whitebooks.in | Live GSTN/NIC submissions. Rate limit by plan. |