e-Way Bill Validity Extension API

Extend e-Way Bill validity when consignment delays prevent completion within original validity period. Within 8-hour pre/post-expiry window.

Get sandbox keys → View OpenAPI docs Talk to sales

What is the e-Way Bill Validity Extension API?

The e-Way Bill Validity Extension API requests additional validity time for an EWB when transit delays prevent completion within the original validity. Per CBIC rules, extension can be requested within 8 hours before or after the EWB expiry — beyond that, fresh EWB is required.

Common reasons: natural calamity, breakdown, vehicle accident, transhipment of goods, law and order issues. The API requires a reason code (NIC standard) and remarks describing the situation.

Quick spec

Code examples

curl Node.jsPythonJava 
curl -X POST 'https://apisandbox.whitebooks.in/eway/api/v1/eway/extend' \
  -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/extend', {
  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/extend',
    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/extend"))
    .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

When can extension be requested?

Within 8 hours before EWB expiry or within 8 hours after expiry. Beyond that, fresh EWB required.

What reason codes are valid?

1: Natural Calamity, 2: Law and Order, 3: Transhipment, 4: Vehicle Breakdown, 5: Other (with mandatory remarks).

How much extension is granted?

Validity extended per remaining distance — same 1-day-per-200km formula applies to the additional distance.

Can I extend multiple times?

Yes within the rules — each extension is a separate request with reason code.

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 → Consolidated e-Way Bill API →
Schedule Demo