All e-way bill and e-invoice API calls

Update the transporter on an e-way bill

POST /v1/ewaybill/update-transporter

Short answer

Send the e-way bill number and the new transporter's ID (their GSTIN or TRANSIN). The transporter on the e-way bill changes and you get the update time back.

Cost: 3 credits per successful call. A rejection or an upstream failure is never charged.

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 change the transporter

Only the current transporter can change it. If no transporter has been assigned, the generator of the e-way bill can.

The e-way bill must be active and within its validity, and the transporter ID must be a valid GSTIN or TRANSIN.

What happens next

The new transporter then sees the e-way bill in their own list (see the transporter list call) and can update the vehicle and extend validity.

Request fields

FieldTypeRequiredMeaning
gstinstringYesThe GSTIN you act as, with API access set up.
gstin_usernamestringYesThe e-way bill API username for that GSTIN. Never stored.
passwordstringYesThe matching API password. Never stored.
ewaybill_nostringYesThe e-way bill number.
transporter_idstringYesThe new transporter's GSTIN or TRANSIN.
test_modebooleanNotrue 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/update-transporter" \
  -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", "ewaybill_no": "351000000123", "transporter_id": "27AAAAA0000A1Z5", "test_mode": true }'

Response

{
  "success": true,
  "ewaybill_no": "351000000123",
  "transporter_id": "27AAAAA0000A1Z5",
  "transporter_update_date": "23/10/2026 11:28:00 AM",
  "billed_to": "paid",
  "credits_remaining": 197
}

Errors you can expect

CodeMessageWhat to do
301Invalid eway bill numberThe e-way bill number does not exist. Check the 12 digits.

All e-way bill API error codes

Questions

Can I remove a transporter?
The call assigns or replaces a transporter. This page documents only that: it does not describe clearing the field.

Related calls

Create a free accountFull 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.