All e-way bill and e-invoice API calls

Close an e-way bill

POST /v1/ewaybill/close

Short answer

Send the e-way bill number and the closure date once the goods movement it covers has actually happened. It marks the e-way bill as closed, which is different from cancelling one that should never have existed.

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.

Close or cancel?

Closing records that the movement finished as planned. Cancelling withdraws an e-way bill that should not have been issued, and is limited to 24 hours from generation.

Use close for a normal, completed delivery. Use cancel when the e-way bill itself was wrong.

Date format

closure_date is dd/MM/yyyy. remarks is optional free text.

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 close.
closure_datestringYesdd/MM/yyyy.
remarksstringNoFree text.
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/close" \
  -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", "closure_date": "24/10/2026", "remarks": "Goods delivered", "test_mode": true }'

Response

{
  "success": true,
  "ewaybill_no": "351000000123",
  "close_date": "24/10/2026",
  "billed_to": "paid",
  "credits_remaining": 197
}

Questions

Is closing mandatory?
Closing is an action you take on a delivered e-way bill. This page documents the call, not whether your business has to use it.

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.