# Initiate Multi-Vehicle E-Waybills

You can update Multi-Vehicle E-Waybills by sending a **`PUT`** request to E-Invoicing API with the following request headers.

### Request Method

PUT

### Request URL

```
{{HOST}}/einv/v1/ewaybill/multi-vehicle
```

### Request Headers

<table><thead><tr><th width="212.38483991363452">Parameter</th><th width="163.99628544055864">Field Validations</th><th width="150">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>X-Cleartax-Auth-Token</td><td>Header</td><td>String</td><td>Mandatory. The auth token generated from ClearTax user id and password. <a href="https://docs.cleartax.in/cleartax-for-developers/e-invoicing-api/e-invoicing-api-reference/authentication-token">Know how.</a></td></tr><tr><td>gstin</td><td>Header</td><td>String</td><td>Mandatory. GSTIN number for the user</td></tr></tbody></table>

### Request Path Params

There are no path parameters for this API.

### Request Query Params

There are no query parameters for this API.

### Request Body

<table><thead><tr><th width="206.99993896484375">Parameter</th><th width="177">Field Validations</th><th width="145.333251953125">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>EwbNumber</td><td>12 Characters</td><td>String</td><td>Conditional. E-Way bill number. </td></tr><tr><td>FromPlace</td><td>Max = 50 Characters</td><td>String</td><td>Mandatory. From place. </td></tr><tr><td>FromState</td><td>Max = 2 Characters</td><td>Number</td><td>Mandatory. From state code. </td></tr><tr><td>ToPlace</td><td>Max = 50 Characters</td><td>String</td><td>Mandatory. To place. </td></tr><tr><td>ToState</td><td>Max = 2 Characters</td><td>Number</td><td>Mandatory. To state code. </td></tr><tr><td>TransMode</td><td><p>Enum: </p><p>ROAD</p><p>RAIL</p><p>AIR</p><p>SHIP</p><p><br></p></td><td>String</td><td>Mandatory. Mode of transport. </td></tr><tr><td><p>TotalQuantity</p><p><br></p></td><td>NA</td><td>Number</td><td>Mandatory. Total quantity of the goods. </td></tr><tr><td>UnitOfMeasurement</td><td>Refer to <a href="https://docs.cleartax.in/cleartax-docs/e-invoicing-api/e-invoicing-api-reference/resources-and-master/unit-master">masters</a>. </td><td>String</td><td>Mandatory. Unit of Measurement. </td></tr><tr><td><p>GroupNumber</p><p><br></p></td><td>NA</td><td>Number</td><td>Mandatory. Group number should always be 0 to initiate multivehicle EWB.</td></tr><tr><td>VehicleListDetails</td><td>NA</td><td>List</td><td>Details of Vehicle</td></tr></tbody></table>

#### Vehicle List Details Object

| Parameter      | Data Type | Field Validations | Description                          |
| -------------- | --------- | ----------------- | ------------------------------------ |
| VehicleNo      | String    | NA                | Mandatory. Vehicle Number.           |
| DocumentNumber | String    | NA                | Optional. Document Number.           |
| DocumentDate   | String    | NA                | Optional. Document  date.            |
| Quantity       | Number    | NA                | Mandatory. Quantity in each vehicle. |

### Response Status Codes

| HTTP Status Code | Description                                                                  |
| ---------------- | ---------------------------------------------------------------------------- |
| 200              | For a successfully processed request (may be a success or validation error). |
| 401              | If the user is not authenticated for the operation.                          |
| 403              | If the user is not authorized for the operation.                             |
| 500              | If there are any unhandled exceptions on the Clear side.                     |

### Response Schema

| Parameter   | Data Type | Field Validations | Description                                |
| ----------- | --------- | ----------------- | ------------------------------------------ |
| EwbNumber   | Number    | 12 Characters     | E-Way bill number.                         |
| GroupNumber | Number    | NA                | Group Number                               |
| UpdatedDate | String    | NA                | Date and time of update.                   |
| errors      | List      | NA                | Array of objects containing error details. |

#### Errors object details

| Parameter      | Data Type | Field Validations                          | Description                                                               |
| -------------- | --------- | ------------------------------------------ | ------------------------------------------------------------------------- |
| error\_code    | Number    | NA                                         | Error Code. If there is no error, then this field will not be present.    |
| error\_message | String    | NA                                         | Error message. If there is no error, then this field will not be present. |
| error\_source  | String    | <p>Enum: </p><p>CLEARTAX,</p><p>GOVT. </p> | Error Source. If there is no error, then this field will not be present.  |

### Sample Request and Response

#### Request&#x20;

```json
{
    "EwbNumber": 171009166265,
    "FromPlace": "Bangalore",
    "FromState": 29,
    "ToPlace": "Mumbai",
    "ToState": 33,
    "TransMode": "ROAD",
    "TotalQuantity": 100.345,
    "UnitOfMeasurement": "BAG",
    "GroupNumber": 0,
    "VehicleListDetails": [
      {
        "VehicleNo": "KA12AS1234",
        "DocumentNumber": "23DF34FG45",
        "DocumentDate": "12/12/2020",
        "Quantity": 100.345
      }
    ]
}
```

#### Response - Success:&#x20;

**HTTP Status Code - 200 OK**

```json
{
    "EwbNumber": 171009166265,
    "GroupNumber": 1,
    "UpdatedDate": "08/02/2021 12:03:00 PM",
    "errors": null
}
```

#### Response - Failure:&#x20;

**HTTP Status Code - 200 OK**

```json
{
    "EwbNumber": null,
    "GroupNumber": 0,
    "UpdatedDate": null,
    "errors": [
        {
            "error_code": "2000",
            "error_message": "Quantity in Group cannot exceed total quantity in E-Way Bill.",
            "error_source": "CLEARTAX"
        }
    ]
}
```

### API Validations

The total quantity should be greater than the sum of all the group quantities. &#x20;

### API Constraints

EWB should be present in the ClearTax database.