Does it cost per e-way bill?

No. It is one charge for the trip sheet, whatever the number of e-way bills on it.

Can I use it for a transporter fleet?

Yes. As the assigned transporter of the e-way bills you can combine them. Use the transporter list to see which ones are assigned to you.

All e-way bill and e-invoice API calls

Generate a consolidated e-way bill (trip sheet)

POST /v1/ewaybill/consolidated

Short answer

Send the list of e-way bill numbers moving on one vehicle, where the vehicle is and the transport mode. You get one consolidated e-way bill number, the trip sheet, back.

Cost: 3 credits per successful call. A rejection or an upstream failure is never charged. One charge however many e-way bills it carries.

Every call accepts "test_mode": true and returns a sample in the live shape, free. Set up your API credentials before the first real call.

Who can add an e-way bill

You must be the generator or the assigned transporter of every e-way bill you add, and each must be active, not cancelled. One e-way bill the network does not recognise stops the whole request, with error 301.

Road, rail, air or ship

trans_mode is 1 Road, 2 Rail, 3 Air, 4 Ship. For road, send vehicle_no. For rail, air or ship, send the transport document number and date (dd/MM/yyyy) instead.

After you generate it

Read it back with the consolidated details call. If the vehicle changes, regenerate it: that issues a new number and cancels the old one.

Request fields

Field	Type	Required	Meaning
gstin	string	Yes	The GSTIN you act as, with API access set up.
gstin_username	string	Yes	The e-way bill API username for that GSTIN. Never stored.
password	string	Yes	The matching API password. Never stored.
ewaybill_nos	array	Yes	The 12-digit e-way bill numbers to combine.
from_place	string	Yes	Where the vehicle is now.
from_state	integer	Yes	State code of that place.
trans_mode	string	Yes	1 Road, 2 Rail, 3 Air, 4 Ship.
vehicle_no	string	No	For road.
trans_doc_no / trans_doc_date	string	No	For rail, air or ship.
test_mode	boolean	No	true returns a sample in the live shape: free, nothing is filed.

Send your API key in the x-api-key header. Government API credentials are used for the one call and never stored.

Example

The request below runs in test mode, so it is free and files nothing. Remove test_mode for a real call.

curl -X POST "https://www.gstinapi.in/v1/ewaybill/consolidated" \
  -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{ "gstin": "24AAAAA0000A1Z5", "gstin_username": "YOUR_EWB_API_USER", "password": "YOUR_EWB_API_PASSWORD", "from_place": "SURAT", "from_state": 24, "trans_mode": "1", "vehicle_no": "GJ05AB1234", "ewaybill_nos": ["351000000123", "351000000456"], "test_mode": true }'

Response

{
  "success": true,
  "consolidated_ewaybill_no": "6664724106",
  "consolidated_ewaybill_date": "23/10/2026 10:50:00 AM",
  "ewaybill_count": 2,
  "billed_to": "paid",
  "credits_remaining": 197
}

Errors you can expect

Code	Message	What to do
301	Invalid eway bill number	One of the e-way bill numbers does not exist, or is not visible to your GSTIN.

All e-way bill API error codes

Questions

Does it cost per e-way bill?: No. It is one charge for the trip sheet, whatever the number of e-way bills on it.
Can I use it for a transporter fleet?: Yes. As the assigned transporter of the e-way bills you can combine them. Use the transporter list to see which ones are assigned to you.

Create a free account Full API reference

Not affiliated with the Government of India. Rules are the government network's own and can change; if a page here looks out of date, tell us.