Close E-Way Bill

A new e-Way Bill Closure facility has been introduced in the e-Way Bill system voluntarily to enable closure of the e-Way Bill once delivery of goods is completed.

Request method

Post

Request URL

{Host}/einv/v2/eInvoice/ewaybill/close

Request Headers

PARAMETER	Data Type	Field Validations	Description
X-Cleartax-Auth-Token	String	NA	Mandatory. The auth token generated from ClearTax user id and password
Content-Type	String	NA	Mandatory. This will always be application/json for JSON.
gstin	String	NA	Mandatory. GSTIN number for the user

Request Body

Parameter	Data Type	Description
ewbNo	integer	Mandatory. The NIC E-Way Bill number to close.
closureDate	string	Mandatory. Format accepted:YYYY-MM-DD
closureRmrk	string	Mandatory. Min Length: 03 Max Length: 50 alphanumeric (NIC remarks max 50).

Sample Request & Response

{
  "ewbNo": 391000123456,
  "closureDate": "2026-06-01",
  "closureRmrk": "Delivered the order"
}

Response - Success:

HTTP Status code - 200

{


  "ewbNumber": 391000123456,
  "ewbStatus": "GENERATED",
  "ewbClosureStatus": "Closed"
  "errorDetails": null
  "closureRmrk":  "Delivered the order",
  "closureDate": "2026-06-01"
}

Response Status Codes

401 – Authentication Failure:

{ "errorCode": "401", "errorMsg": "Authentication failed", "errorSource": "CLEARTAX" }

403- You don't have access

{
    "error_code": "403",
    "error_message": "You don't have access",
    "error_source": "CLEARTAX"
}

Validation Errors:

1. When the Closure date is before the EWB generation date

Sample Request :

{
  "ewbNo": 391000123456,
  "closureDate": "2026-05-18",
  "closureRmrk": "Delivered the order"
}

Sample Response:

 {


  "ewbNumber": 391000123456,
  "ewbStatus": "GENERATED",
  "ewbClosureStatus": "Not Closed"
  "errorDetails": {
       "error_code": "500",
       "error_message": "Closure Date cannot be before the E-Way Bill generation date for EwayBill 391000123456. Please correct the Closure Date and try again."
       "error_source": "CLEARTAX"
  },
  "closureRmrk":  null,
  "closureDate": null
}

1. When the Closure date is a future date

Sample Request :

{
  "ewbNo": 391000123456,
  "closureDate": "2026-06-18",
  "closureRmrk": "Delivered the order"
}

Sample Response:

{
"ewbNumber": 391000123456,
  "ewbStatus": "GENERATED",
  "ewbClosureStatus": "Not Closed"
  "errorDetails": {
       "error_code": "500",
       "error_message": "Closure Date cannot be in the future for EwayBill 391000123456. Please correct the Closure   Date and try again."
       "error_source": "CLEARTAX"
  },
  "closureRmrk":  null,
  "closureDate": null
} 

3. When EWB is already closed

Sample Request :

{
  "ewbNo": 391000123456,
  "closureDate": "2026-06-01",
  "closureRmrk": "Delivered the order"

Sample Response:

{

"ewbNumber": 391000123456,
  "ewbStatus": "GENERATED",
  "ewbClosureStatus": "Closed"
  "errorDetails": {
       "error_code": "500",
       "error_message": "EwayBill 391000123456 is already CLOSED"
       "error_source": "CLEARTAX"
  },
  "closureRmrk":  null,
  "closureDate": null
}

API Validations

Currently, there are no known validations for this API.

API Constraints

Currently, there are no known constraints for this API.