e-Way Bill API · GSTN-Authorised GSP e-Way Bill API Provider:
Generate, Extend & Cancel via API
Create e-Way Bills from your ERP or logistics system at every dispatch, update vehicles in transit and extend validity through Figment’s GSTN-authorised GSP, connected to all NIC backup e-Way Bill portals.
- GSTN-Authorised GSP
- All NIC Backup Portals
- 99% API Uptime
- Data Hosted in India
- Go-Live in ~2 Weeks
Trusted by Banks, PSUs and Leading Enterprises Across India
e-Way Bill Rules Your System Must Handle
Figment’s e-Way Bill API checks each of these before the request reaches the NIC system.
When an e-Way Bill is needed
For movement of goods worth more than ₹50,000 per consignment. Some states set a different threshold for movement within the state.
Validity by distance
One day for every 200 km for regular cargo, and one day for every 20 km for over-dimensional cargo.
Extension window
Validity can be extended from 8 hours before to 8 hours after expiry. Total extensions are capped at 360 days from the original generation date.
180-day document limit
An e-Way Bill cannot be generated for an invoice or document dated more than 180 days earlier.
Cancellation and rejection
The generator can cancel within 24 hours if goods have not moved. The recipient can reject within 72 hours.
Part-B and vehicle changes
Vehicle details go in Part-B and must be updated when goods change vehicle or mode in transit.
e-Way Bill APIs Available Through Figment GSP
REST/JSON APIs on the NIC e-Way Bill system’s official interface, with sandbox access and a Postman collection.
e-Way Bill Generation API
Returns the e-Way Bill number, date and validity.
e-Way Bill by IRN API
Generates the e-Way Bill from an e-Invoice IRN, with no re-entry of invoice data.
Part-B / Vehicle Update API
Updates the vehicle number or transport mode in transit.
Multi-Vehicle API
Moves one consignment across several vehicles.
Validity Extension API
Extends validity when goods are delayed in transit.
Transporter Update API
Assigns or changes the transporter ID.
e-Way Bill Cancellation API
Cancels an e-Way Bill within 24 hours, or rejects one raised on you.
Consolidated e-Way Bill API
Combines multiple e-Way Bills into one EWB-02 for a vehicle.
e-Way Bill Lookup API
Fetches e-Way Bills by number, date, generator or transporter.
Pincode Distance API
Calculates the distance between pincodes to set e-Way Bill validity correctly.
E-WAY BILL GENERATED
312 km: valid for 2 days
- EWB no.
- 181000000002
- Distance
- 312 km (Pincode Distance API)
- Valid until
- 03 Oct 2026, 23:59
- Vehicle
- MH31AB1234
Illustrative demo data. Not a real taxpayer.
From Dispatch to e-Way Bill Automatically
- STEP 1
Dispatch in your ERP
The delivery or invoice is created in SAP, Oracle, Tally or your logistics system.
- STEP 2
Send to Figment GSP
The system posts consignment and vehicle details, or just the IRN, to the e-Way Bill API.
- STEP 3
Generate on NIC
Figment generates the e-Way Bill on NIC, switching to a backup portal if the primary is unavailable.
- NIC e-Way Bill
- NIC backup portals
- STEP 4
Number back to the gate
The e-Way Bill number and validity return to your system and print on the dispatch documents.
e-Way Bill API Integration: What Happens After You Request Sandbox Access
You talk to our API team, get a sandbox and go live with their help.
- 1
Request access
Share your company, the APIs you need and your ERP or software.
2 minutes - 2
Our API team gets in touch
We confirm your use case and set up your sandbox.
Personal onboarding - 3
Sandbox credentials by email
With test GSTINs, sample payloads, the Postman collection and documentation.
Separate from production - 4
Go live
On the e-Way Bill portal: Registration → For GSP → Figment Global Solutions, then create the API username.
~2 weeks from sandbox
Common e-Way Bill API Errors and Fixes
GSTIN blocked from generating e-Way Bills
The GSTIN has not filed returns for two or more periods. Check it with the e-Way Bill Block Check API before dispatch and file the pending returns.
Distance does not match the PIN codes
The portal checks the distance against the PIN-to-PIN distance. Use the Pincode Distance API and stay within the allowed range.
Vehicle details missing (Part-B)
The e-Way Bill is not valid for movement without Part-B. Send the vehicle number with the Part-B / Vehicle Update API before the goods move.
NIC Backup Portals for Uninterrupted Dispatch
When e-Way Bills stop, trucks wait at the gate. Figment’s GSP is connected to all NIC backup e-Way Bill portals and built with redundancy at every layer.
Redundant Links
Redundant links from Figment GSP to the NIC e-Way Bill system, with automatic switchover if a link drops.
DR Site, Data in India
A dedicated disaster-recovery site, with all data hosted in India only.
Queued Retries, No Duplicates
Timeouts are retried automatically, with checks that stop one invoice getting two IRNs or two e-Way Bills.
99% API Uptime
Redundancy at every layer keeps the API available 99% of the time, including month-end billing peaks.
e-Way Bill API for SAP, ERPs and Transporters
The API takes the same e-Way Bill JSON from any system, so integration is about where your dispatch or delivery document lives.
SAP ECC and S/4HANA
Generate the e-Way Bill at outbound delivery or billing, and write the number and validity back to the document for the driver’s copy.
Oracle and Microsoft Dynamics 365
Call the API from the shipment or invoice posting flow, with bulk runs for high-volume dispatch days.
Tally Prime
Connect Tally Prime through your Tally partner or middleware; the API receives the same e-Way Bill JSON as from any ERP.
Transporters and logistics platforms
Update Part-B and vehicles in transit, move goods across several vehicles and create consolidated e-Way Bills (EWB-02) per vehicle.
e-Invoice users
Generate the e-Way Bill from the IRN in the same flow as the e-Invoice, with no re-entry of invoice data.
Trusted for e-Way Bills by PSUs and Enterprises
Oil, Gas & Petrochemicals
Client: ONGC
Frequent tanker and cargo movements from plants, depots and terminals, with multi-vehicle and consolidated e-Way Bills.
Mining & Metals
Client: MOIL Limited
Bulk ore movement from mine to siding or port, with Part-B updates and validity extensions on long hauls.
Manufacturing & FMCG
Client: ITC
e-Way Bills raised automatically at dispatch from SAP across plants and warehouses.
Logistics & Transporters
Update vehicles, assign transporters and consolidate e-Way Bills from your transport management system.
e-Way Bill API Pricing: What Decides the Cost
e-Way Bill API pricing in India is usually based on usage. These are the factors that decide your quote.
e-Way Bill volume
How many e-Way Bills, updates and extensions you create a month.
GSTINs and locations
The number of registrations, plants and depots dispatching through the API.
APIs used
e-Way Bill alone, or with e-Invoice, GSTIN verification and distance APIs.
Support and SLA
Uptime commitments, support hours and tender or audit documentation you need.
Switching Your e-Way Bill API Provider?
If trucks wait at the gate because your current provider has no backup portal, slow support or sandbox delays, test Figment alongside it and move when you are ready.
- Sandbox access while your current provider keeps running
- Help mapping your current payloads, authentication and error codes
- Cut-over with no change to how your dispatch team works
- 01
Today
ERP / Tally Current provider NIC EWBLIVE - 02
Test Figment in parallel
ERP / TallyCurrent provider NIC EWBFigment sandbox LIVE ↑TEST ↓NO CHANGE TO LIVE DISPATCH - 03
Cut over when you are ready
ERP / Tally Figment GSP NIC EWBCurrent provider: off ONE API AT A TIME
Related Figment APIs and Products
e-Invoice API →
Generate IRNs and e-Way Bills in one flow.
All GSP APIs →
GSTIN verification, GST return filing, e-Invoice and e-Way Bill APIs.
GSTCPC →
Ready GST software with e-Way Bill, returns and reconciliation.
Automate Every e-Way Bill Through Figment GSP
Get sandbox keys today. Most e-Way Bill integrations go live in about two weeks.
Frequently Asked Questions
Something not covered here?
Ask us directly.An e-Way Bill API lets your ERP, logistics or transport system generate, update, extend and cancel e-Way Bills on the NIC e-Way Bill system directly, without anyone logging in to the e-Way Bill portal. Figment provides it as a GSTN-authorised GST Suvidha Provider.
An e-Way Bill is required for movement of goods worth more than ₹50,000 per consignment. Some states set a different threshold for movement within the state.
Validity is one day for every 200 km for regular cargo and one day for every 20 km for over-dimensional cargo. Figment’s Pincode Distance API helps set the distance, and so the validity, correctly.
Yes. The Validity Extension API extends validity from 8 hours before to 8 hours after expiry. Total extensions are capped at 360 days from the date the e-Way Bill was first generated.
Yes. The generator can cancel an e-Way Bill within 24 hours if the goods have not moved, and the recipient can reject one within 72 hours. Both actions are available through Figment’s API.
Figment GSP is connected to all NIC backup e-Way Bill portals and has redundant links to the NIC system, so requests continue during maintenance windows or peak load.
Yes. The e-Way Bill by IRN API generates the e-Way Bill from an existing IRN, so invoice details are not entered twice.
Yes. The Consolidated e-Way Bill API combines several e-Way Bills into one EWB-02 for a vehicle, and the Multi-Vehicle API moves one consignment across several vehicles.
Log in to the e-Way Bill portal with your GSTIN, open Registration and choose For GSP. Select Figment Global Solutions as your GSP and create the API username and password your ERP or logistics system will use.
A GSP (GST Suvidha Provider) is an authorised channel that connects your ERP or logistics software to the NIC e-Way Bill system through APIs, so e-Way Bills are created from your own system instead of the portal. Figment is a GSTN-authorised GSP.
It is the API username you create on the e-Way Bill portal under Registration, For GSP, after selecting your GSP. Your system uses this username and its password, through the GSP, to call the e-Way Bill APIs; it is separate from your portal login.
Yes. Figment gives you sandbox credentials with test GSTINs, sample consignments, PIN codes and a Postman collection. Nothing in the sandbox creates a live e-Way Bill.
e-Way Bill API pricing usually depends on your monthly e-Way Bill volume, the number of GSTINs and locations, which APIs you use and the support level you need. Contact Figment for a quote based on your volumes.
e-Way Bill generation is blocked when returns have not been filed for two or more tax periods. Figment’s e-Way Bill Block Check API tells you before dispatch whether a GSTIN is blocked.
Yes. Get sandbox access while your current provider keeps running. Figment's API team maps your existing payloads, authentication and error codes, and you cut over without changing how your dispatch team works. If your current provider is down, ask for priority onboarding.