Consolidated e-Way Bill API

Combine multiple individual EWBs into a single consolidated EWB for transporters carrying multiple consignments on the same vehicle.

Get sandbox keys → View OpenAPI docs Talk to sales

What is the Consolidated e-Way Bill API?

A Consolidated e-Way Bill (CEWB) lets a transporter combine up to 10 individual EWBs into a single document for movement on the same vehicle on the same route. Used heavily in logistics (LTL — less-than-truckload — shipments) and in milk-run distribution.

The API takes a list of individual EWB numbers and the common vehicle details, validates all EWBs are active + share a compatible route, and issues a single consolidated EWB number. The transporter carries the consolidated EWB; individual EWBs remain valid as audit trail.

Quick spec

Code examples

curl Node.jsPythonJava 
curl -X POST 'https://apisandbox.whitebooks.in/eway/api/v1/eway/consolidated/generate' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ /* payload */ }'
Node.js 
const res = await fetch('https://apisandbox.whitebooks.in/eway/api/v1/eway/consolidated/generate', {
  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/eway/api/v1/eway/consolidated/generate',
    headers={'Authorization': f'Bearer {access_token}'},
    json=payload,
)
data = resp.json()
Java 
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://apisandbox.whitebooks.in/eway/api/v1/eway/consolidated/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

How many EWBs can be consolidated?

Up to 10 per consolidated EWB. For more, generate multiple consolidated EWBs.

What validations apply?

All EWBs must share the same vehicle, common origin/destination corridor, and overlap in validity period.

How is consolidated EWB cancelled?

Cancellation of consolidated EWB does NOT cancel underlying individual EWBs — they remain active.

Is this useful for milk-run distribution?

Yes — typical use case. Consolidated EWB covers the vehicle journey; individual EWBs cover each customer drop.

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.

Open the e-Way Bill API page →

Related e-Way Bill API endpoints

e-Way Bill Generation API → e-Way Bill Cancellation API → Part-B Update API → e-Way Bill Validity Extension API →
Schedule Demo