NIC-Compliant e-Way Bill API

What is the NIC-Compliant e-Way Bill API?

NIC (National Informatics Centre) operates the official e-Way Bill portal. WhiteBooks holds direct NIC EWB API access and routes every e-Way Bill request through the official channel — not screen-scraped or reverse-engineered.

NIC publishes API schema updates and downtime windows to channel partners in advance. WhiteBooks consumers are insulated from these upstream changes — schema migrations are handled inside the WhiteBooks API layer with backward compatibility.

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