Integration Guides

E-Way Bill API Integration for Logistics Software

E-way bill rules that software must encode, how API access works, the main API operations, validity and extension logic, and what transporters and shippers should build.

Purushottam Kumar Suman

Founder & CEO, Drema AI

September 21, 20267 min read

X LinkedIn Instagram

An e-way bill is the electronic permit that must accompany goods in transit under GST. A vehicle stopped without a valid one faces detention and penalty. For shippers and transporters moving many consignments a day, generating and updating e-way bills on the portal by hand is slow and error-prone, which is why they integrate.

The rules your software must know

The core rules are stable, though states can vary thresholds for movement within the state.

When requiredMovement of goods with consignment value above ₹50,000, with exceptions and state-specific limits for intra-state movement

Part AInvoice or challan details: GSTINs, document number and date, items, HSN, value and tax

Part BTransport details: vehicle number or transport document number. The e-way bill is valid for movement only after Part B is filled

Who generatesSupplier or recipient; the transporter if neither has

ValidityOne day for every 200 km or part for regular cargo; shorter distance per day for over-dimensional cargo

CancellationWithin 24 hours of generation, if the goods did not move

₹50,000

Consignment value threshold

200 km

Per day of validity for regular cargo

180 days

Maximum age of the base document

Recent restrictions

Since January 2025 the system does not allow an e-way bill to be generated on a document dated more than 180 days earlier, and extensions are capped at 360 days from the original generation date. Two-factor authentication is required for portal and API users. A second portal, E-Way Bill 2.0, runs alongside the first with synchronised data to provide continuity.

Getting API access

API access is given to taxpayers and transporters, not to software vendors as such.

Through a GST Suvidha ProviderThe common route: the GSP supplies credentials, sandbox and uptime; the taxpayer creates an API user on the e-way bill portal for that GSP

DirectFor taxpayers who meet the volume criteria and infrastructure conditions such as whitelisted static IPs

Through e-invoicingFor e-invoiced supplies, the e-way bill can be generated in the same call as the IRN or from the IRN later

The API operations

Authentication yields a session token; payloads are encrypted. The main operations are below.

Expiry in transit is the costly failure. Software should warn hours before, not after.

GenerateCreate an e-way bill with Part A and optionally Part B

Update Part BAdd or change vehicle details, including when goods are moved to another vehicle

Consolidated e-way billOne document for many consignments in one vehicle

Update transporterAssign or change the transporter ID

Extend validityWithin the permitted window around expiry, with a reason and current location

Cancel and rejectCancel by the generator; reject by the other party

GetFetch details, and list e-way bills assigned to a transporter or generated by others on your GSTIN

What to build for transporters

A transporter's system works mostly with e-way bills generated by its customers.

Fetch bills assigned to transporter IDLink to lorry receipt and tripBulk Part B update on vehicle allocationConsolidated bills per vehicleVehicle change at hubsExpiry dashboardExtension workflowDriver app with e-way bill copies

What to build for shippers

For manufacturers and distributors, generate the e-way bill from the invoice at dispatch, with distance calculated from PIN codes and validated against the portal's figure. Validate GSTINs, HSN codes and vehicle number formats before calling the API, queue requests with retries for portal downtime, and store the e-way bill number against the invoice. Reconcile e-way bills with GSTR-1, because mismatches are a common trigger for notices.

Sources · last reviewed October 1, 2026

This article explains what to build, not legal advice. Rules change; confirm against the current official text before relying on it.

Written by

Purushottam Kumar Suman

Founder & CEO, Drema AI

Founder and CEO of Drema AI. Builds AI systems, SaaS platforms and industry software — and writes about what actually survives production.

X LinkedIn Instagram