GST API Sandbox — Free Test Environment

Free sandbox environment for testing the WhiteBooks GST API. Stateful replica of GSTN/NIC behavior, no credit card needed.

Get sandbox keys → View OpenAPI docs Talk to sales

What is the GST API Sandbox — Free Test Environment?

The WhiteBooks GST API Sandbox is a stateful replica of the GSTN/NIC production environment, available at apisandbox.whitebooks.in. It mirrors all production endpoints — GSTR filing, GSTR-2B fetch, GSTIN verify, HSN search — but operates against a dummy ledger so test invoices don't hit the real GSTN.

Signup → sandbox credentials → first call typically takes under 60 seconds — no sales call, no PII required, no credit card. The sandbox supports persistent state per developer account so multi-step integration testing (file GSTR-1, then fetch GSTR-2B for matching) works realistically.

Quick spec

Code examples

curl Node.jsPythonJava 
curl -X POST 'https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'
Node.js 
const res = await fetch('https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});
const data = await res.json();
Python 
import requests

resp = requests.post(
    'https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file',
    headers={'Authorization': f'Bearer {access_token}'},
    json=payload,
)
data = resp.json()
Java 
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/gst/api/v1/gstr1/file"))
    .header("Authorization", "Bearer " + accessToken)
    .header("Content-Type", "application/json")
    .post(BodyPublishers.ofString(payload))
    .build();
HttpResponse<String> resp = HttpClient.newHttpClient()
    .send(req, BodyHandlers.ofString());

Integrate in 3 steps

  1. Sign up at accounts.whitebooks.in — sandbox credentials issued instantly, no sales gate.
  2. Make your first call against the sandbox base URL using the code example above. Validate against your local model.
  3. Move to production once your tests pass — switch host to https://api.whitebooks.in/gst. Same payload, same response shape.

Frequently asked questions

How do I get sandbox credentials?

Sign up at accounts.whitebooks.in/signup?type=Developer. Sandbox client_id and client_secret are issued instantly — no human review.

Does the sandbox cost anything?

No — completely free. No credit card required at signup.

Is the sandbox state persistent?

Yes — files you submit are retained for 30 days. Reset on demand via the developer dashboard.

Does the sandbox simulate failure modes?

Yes — special test GSTINs trigger specific GSTN error responses (e.g., suspended GSTIN, invalid PAN) so you can exercise error-handling paths.

Explore the full GST API

This is one endpoint inside the WhiteBooks GST API suite. See the full documentation — every endpoint, every parameter, every error code.

Open the GST API page →

Related GST API endpoints

GSTR-1 Filing API → GSTR-2B Fetch API → GSTR-3B Filing API → GSTR-9 Annual Return API →
Schedule Demo