All e-way bill and e-invoice API calls

Reject an e-way bill raised against you

POST /v1/ewaybill/reject

Short answer

Send the e-way bill number of a document another party generated against your GSTIN. It is rejected and you get the rejection time back. It works only within 72 hours of generation, and never on an e-way bill you generated yourself.

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 reject

The other party involved in the e-way bill can reject it when it was generated by the supplier or recipient. The supplier or recipient can reject it when it was generated by the transporter.

The window is 72 hours from generation. After that the e-way bill can no longer be rejected.

Finding what to reject

Use the other-party list to see every e-way bill raised against your GSTIN on a given date, then reject the ones that are not yours.

Trying to reject your own

An e-way bill you generated yourself cannot be rejected. The network answers with error 341 and a plain message. Cancel it instead, within 24 hours.

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 to reject.
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/reject" \
  -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", "test_mode": true }'

Response

{
  "success": true,
  "ewaybill_no": "351000000123",
  "rejected_date": "23/10/2026 10:24:00 AM",
  "billed_to": "paid",
  "credits_remaining": 197
}

Errors you can expect

CodeMessageWhat to do
341This e-way bill is generated by you and hence you cannot reject itCancel your own e-way bill instead, within 24 hours of generating it.

All e-way bill API error codes

Questions

Is a rejected e-way bill the same as a cancelled one?
No. Rejection is done by the other party; cancellation is done by the generator. They have different time limits, 72 hours and 24 hours.

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.