Bulk e-Way Bill Generation API

What is the Bulk e-Way Bill Generation API?

The Bulk e-Way Bill Generation API processes up to 100 EWBs in a single async call. Submit the list, get back a job_id, receive completion via webhook. Each EWB result includes generated EWB number + validity OR a clear failure reason.

Partial success is the norm for large batches — e.g., 95/100 succeed, 3 fail validation, 2 timeout. The API surfaces per-EWB status so retry logic can target only the failures.

Quick spec

• Endpoint: POST /api/v1/eway/generate-bulk
• 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-bulk' \
  -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-bulk', {
  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-bulk',
    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-bulk"))
    .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