e-Way Bill Sandbox API

What is the e-Way Bill Sandbox API?

The WhiteBooks e-Way Bill Sandbox replicates NIC EWB portal behavior — generation, Part-B updates, extension, cancellation, consolidated EWB — against a dummy ledger. Test EWBs never hit the real NIC system.

Signup → sandbox credentials → first EWB generation typically takes under 60 seconds. State persists per developer for 30 days, supporting multi-step flow testing (generate → update Part-B → extend → cancel) realistically.

Quick spec

• Endpoint: POST /api/v1/eway/generate
• Auth: OAuth 2.0 bearer token
• Production base: https://api.whitebooks.in/eway
• Sandbox base: https://apisandbox.whitebooks.in/eway
• Format: JSON in / JSON out
• SLA: 99.99% uptime · p95 < 350ms

Code examples

curl -X POST 'https://apisandbox.whitebooks.in/eway/api/v1/eway/generate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'

const res = await fetch('https://apisandbox.whitebooks.in/eway/api/v1/eway/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});
const data = await res.json();

import requests

resp = requests.post(
    'https://apisandbox.whitebooks.in/eway/api/v1/eway/generate',
    headers={'Authorization': f'Bearer {access_token}'},
    json=payload,
)
data = resp.json()

HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/eway/api/v1/eway/generate"))
    .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/eway. Same payload, same response shape.

Frequently asked questions

Explore the full e-Way Bill API

This is one endpoint inside the WhiteBooks e-Way Bill API suite. See the full documentation — every endpoint, every parameter, every error code.

Related e-Way Bill API endpoints