> For the complete documentation index, see [llms.txt](https://docs.cleartax.in/cleartax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cleartax.in/cleartax-docs/e-invoicing-api/e-invoicing-api-reference/cleartax-e-invoicing-apis-xml-schema/e-waybills-apis/close-e-way-bill.md).

# Close E-Way Bill

### **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                | <p>Mandatory. This will always be                                      |
| <br>application/json<br>for JSON.</p> |           |                   |                                                                        |
| gstin                                 | String    | NA                | Mandatory. GSTIN number for the user                                   |

### Request Body

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

### Sample Request & Response

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

```

Response - **Success:**

**HTTP Status code - 200**

```json
{


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

```

### Response Status Codes

\
401 – Authentication Failure:

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

403- You don't have access&#x20;

```json
{
    "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 :**

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

```

**Sample Response:**

```json
 {


  "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
}


```

2. When the Closure date is a future date

**Sample Request :**

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

```

**Sample Response:**

<pre class="language-json"><code class="lang-json">{
"ewbNumber": 391000123456,
  "ewbStatus": "GENERATED",
<strong>  "ewbClosureStatus": "Not Closed"
</strong>  "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
} 

</code></pre>

3\. When EWB is already closed

**Sample Request :**

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

```

**Sample Response:**

```json
{

"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.