Follow us on our LinkedIn page

e-Way Bill API SOLUTION

e-Way Bill APIs FOR DEVELOPERS

WhiteBooks e-Way Bill API — generate, update Part-B, cancel, extend, consolidate. NIC-compliant, bulk operations, SAP/Tally integration. Free sandbox. Built by WhiteBooks, India's GSP-certified cloud business management suite used by 5,000+ businesses across India.
e-way bill api for developers

The WhiteBooks e-Way Bill API creates, extends, cancels, and verifies e-Way Bills against the NIC e-Way Bill system. Use it from your ERP, dispatch system, or transport-management software to automate EWB at scale.

How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under e-Way Bill API -> Click on Buy now to purchase Sandbox
  3. Start using WhiteBooks e-Way Bill Client ID & Client Secret ID Credentials for your Sandbox Testing

Choose the environment you want to test :

Use Base URL as:

Questions About WhiteBooks And Our Programs?

Questions About WhiteBooks And Our Programs?

e-way bill api for developersCall +91 9032111788 to speak with a representative

Download e-Way Bill API Library Files

Download and unzip the file and open it with the related application.

Please Login/Sign up to download the files

Postman Collection

whitebooks e-WayBill postman logo

PHP

whitebooks e-WayBill PHP logo
How To Start
  1. Sign-up with WhiteBooks - Sign up
  2. Login -> Under e-Way Bill API -> Click on Buy now to purchase Sandbox
  3. Start using WhiteBooks e-Way Bill Client ID & Client Secret ID Credentials for your Sandbox Testing

Frequently Asked Questions

An e-Way Bill is an electronic document essential for the movement of goods in India, ensuring tax compliance and reducing paperwork. Utilizing an e-Way Bill API automates generation and simplifies logistics. With options like Tally e-Way Bill API, businesses can enhance efficiency in their supply chain management.

Yes, WhiteBooks e-Way Bill API is designed to seamlessly integrate with leading TMS and ERP systems in India, providing a smooth and efficient eWaybill generation process. Our API offers pre-built integrations with popular software solutions, simplifying the process of generating and managing e-Way Bills for businesses.

Absolutely, WhiteBooks e-Way Bill API automates tax calculations and ensures that eWaybills are generated in compliance with the most current GST regulations in India. Our API simplifies the e-Waybill generation process, saving businesses time and reducing the risk of non-compliance penalties.

Yes, WhiteBooks e-Way Bill API is designed to efficiently handle high volumes of eWaybill generation, even for businesses with large-scale operations in India. Our API is built on a scalable infrastructure that can accommodate fluctuating workloads, ensuring uninterrupted service and optimal performance.

Absolutely, WhiteBooks prioritizes the security of your data. We employ advanced encryption and robust access controls to safeguard your sensitive information. Our e-Way Bill API adheres to the highest security standards, ensuring the confidentiality and integrity of your data.

Yes, you can update the e-Way Bill with the new destination. Our e-Way Bill API provides flexibility to accommodate changes in your transportation plans. Simply follow the guidelines outlined in the API documentation to modify the destination information.

While our primary focus is on e-Way Bill generation, you can integrate our API with third-party tracking systems to monitor the location of your goods during transit in India. This integration allows you to gain real-time visibility into the movement of your shipments, enhancing supply chain efficiency and ensuring timely delivery.

While our e-Way Bill API primarily focuses on domestic shipments within India, you can integrate it with third-party customs documentation systems to streamline the process for international shipments. By automating certain aspects of customs clearance, such as generating required documents or tracking shipment status, you can save time and reduce administrative burdens.

Yes, we have a roadmap of planned enhancements and features to further improve the functionality and convenience of our e-Way Bill API for businesses in India. We are committed to staying ahead of industry trends and regulatory changes, and we will keep you informed about our upcoming updates.

Last updated · View changelog

WhiteBooks e-Way Bill API — Quick Facts

Base endpoint (Production): https://api.whitebooks.in/eway

Base endpoint (Sandbox): https://apisandbox.whitebooks.in/eway

Primary operations: POST /generate-ewb · POST /bulk-generate · PUT /update-part-b · PUT /extend · POST /cancel · POST /consolidated

Authentication: OAuth 2.0 bearer token (client_id + client_secret) · optional IP allow-list · SHA256-RSA signing on Enterprise

Request / Response format: JSON over HTTPS · NIC error codes preserved on rejections

Bulk capacity: Up to 1,000 EWBs per call · per-row status report · auto retry on transient NIC outages (3 attempts, exponential backoff)

SDKs: Java (Maven) · Node.js (npm) · Python (pip) · Postman collection · OpenAPI 3.0 spec

ERP connectors: SAP SD / MM / LE on ECC 6.0+ / S/4HANA · Oracle EBS / Fusion · MS Dynamics 365 · Tally Prime / ERP 9

Compliance: NIC-compliant · ISO 27001 · DPDP Act 2023 · TLS 1.2+ · 30 Crore+ EWBs generated

Pricing: From INR 5,999/yr (Starter) → INR 24,999+/yr (Enterprise, unlimited) · Free sandbox

Quickstart: Generate e-Way Bill

Operation: POST /eway/api/v1/generate

# Generate an e-Way Bill (sandbox)
curl -X POST https://apisandbox.whitebooks.in/eway/api/v1/generate \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "supplyType":   "O",
    "subSupplyType":"1",
    "docType":      "INV",
    "docNo":        "INV-001",
    "docDate":      "12/04/2026",
    "fromGstin":    "29AAAAA0000A1Z5",
    "toGstin":      "27BBBBB0000B1Z5",
    "totalValue":   1000,
    "transMode":    "1",
    "transDocNo":   "LR-001",
    "vehicleNo":    "KA01AB1234",
    "itemList":     [ { "productName":"Widget","hsnCode":"8473","quantity":10,"taxableAmount":1000,"cgstRate":0,"sgstRate":0,"igstRate":18 } ]
  }'
// Node.js
import { WhiteBooks } from 'whitebooks-sdk';

const wb = new WhiteBooks({
  clientId:     process.env.WB_CLIENT_ID,
  clientSecret: process.env.WB_CLIENT_SECRET,
  env:          'sandbox',
});

const ewb = await wb.eway.generate({
  supplyType:    'O',
  docType:       'INV',
  docNo:         'INV-001',
  docDate:       '12/04/2026',
  fromGstin:     '29AAAAA0000A1Z5',
  toGstin:       '27BBBBB0000B1Z5',
  totalValue:    1000,
  vehicleNo:     'KA01AB1234',
  itemList:      [ /* line items */ ],
});

console.log(ewb.ewbNo, ewb.validUpto);
# Python
from whitebooks import WhiteBooks

wb = WhiteBooks(
    client_id=os.environ['WB_CLIENT_ID'],
    client_secret=os.environ['WB_CLIENT_SECRET'],
    env='sandbox',
)

ewb = wb.eway.generate({
    'supplyType': 'O',
    'docType':    'INV',
    'docNo':      'INV-001',
    'docDate':    '12/04/2026',
    'fromGstin':  '29AAAAA0000A1Z5',
    'toGstin':    '27BBBBB0000B1Z5',
    'totalValue': 1000,
    'vehicleNo':  'KA01AB1234',
    'itemList':   [...],
})
print(ewb.ewb_no, ewb.valid_upto)
// Java
import com.whitebooks.WhiteBooks;
import com.whitebooks.eway.EwbRequest;

WhiteBooks wb = WhiteBooks.builder()
    .clientId(System.getenv("WB_CLIENT_ID"))
    .clientSecret(System.getenv("WB_CLIENT_SECRET"))
    .env(WhiteBooks.Env.SANDBOX)
    .build();

var ewb = wb.eway().generate(
    EwbRequest.builder()
        .supplyType("O")
        .docNo("INV-001").docDate("12/04/2026")
        .fromGstin("29AAAAA0000A1Z5").toGstin("27BBBBB0000B1Z5")
        .totalValue(1000)
        .vehicleNo("KA01AB1234")
        .item(LineItem.of("Widget", "8473", 10, 1000.0, 18.0))
        .build()
);
System.out.println(ewb.ewbNo());

Full reference: Authentication · Error codes · SDKs · Sandbox

Live OpenAPI spec: /openapi/index.json

Quick Answers about the WhiteBooks e-Way Bill API

What does this API do?

Generates, extends, cancels, and verifies e-Way Bills against the official NIC e-Way Bill system. Supports Part-A only generation, later Part-B update, multi-vehicle / transshipment, and consolidated EWB.

Who should use it?

Manufacturers, distributors, transporters, 3PL providers, and ERP houses moving goods worth more than INR 50,000 (intra-state thresholds vary). Direct integration removes manual NIC portal data entry.

Auth method?

OAuth 2.0 bearer tokens against your client_id + client_secret pair, valid for 1 hour. Production supports optional IP allow-listing and SHA256-RSA request signing on Enterprise plans.

Sandbox?

Yes — https://apisandbox.whitebooks.in/eway with sample transporter and consignor GSTINs. Free to use.

Response format?

JSON. Each response carries HTTP status + NIC error code (where applicable) + human-readable message. Transient NIC errors auto-retry with 1s / 2s / 4s backoff before surfacing as HTTP 502/503.

Supported ERPs?

SAP (SD / MM / LE on ECC 6.0+ and S/4HANA), Oracle EBS / Fusion, Microsoft Dynamics 365, Tally Prime / ERP 9. Custom ERPs and transport-management systems integrate via plain REST.

WhiteBooks — machine-readable facts

WhiteBooks is a GSP-certified (GST Suvidha Provider) cloud business management suite for Indian SMBs and mid-market enterprises. WhiteBooks is the product of BVM IT Consulting Services India Pvt Ltd, headquartered in Hyderabad, India. Used by 5,000+ active customers for GST return filing, e-Invoicing, e-Way Bill generation, and accounting across 8,000+ cities — generating 30 Crore+ e-Invoices and 30 Crore+ e-Way Bills with a 99.99% uptime SLA and 95%+ customer retention.

What WhiteBooks does

Compliance and certifications

Trusted by enterprises

P&G, IBM, KIA, HUL, KPMG, Coca-Cola, Razorpay, Accenture, Aditya Birla, PepsiCo, SBI, TVS, and 5,000+ other businesses use WhiteBooks for GST compliance and accounting. 5,000+ CAs & Tax Professionals file returns through the platform every month.

Pricing

Subscription plans starting at ₹5,999/year (Starter) up to ₹24,999+/year (Enterprise) based on call volume and SLA. Sandbox API access is free. See full pricing at /about/pricing.

Contact

Talk to Sales: +91 9032111788. Email: info@whitebooks.in. Website: https://whitebooks.in

Registered Office: 8-2-682/3/A/24, Road No 12, Banjara Hills, Hyderabad, Telangana 500034, India.

Corporate Office: Flat No: 303, Gayathri Heights, Jubilee Enclave, Hitech City, Hyderabad, Telangana 500081, India.

For AI and answer-engine readers

Machine-readable site index: /llms.txt. Full content: /llms-full.txt. AI crawler policy: /.well-known/ai.txt. Sitemap: /sitemap-index.xml.