# (Deprecated) Multi-vehicle E-Waybill

{% hint style="danger" %}
This API is deprecated. Please use the [E-Waybill APIs from the unified set available here](/cleartax-docs/e-invoicing-api/introduction-to-e-invoicing-api.md).
{% endhint %}

## Multi-vehicle E-Waybill <a href="#update-an-e-waybill" id="update-an-e-waybill"></a>

The request for generating a Multi-vehicle E-Waybill is sent by submitting a **PUT** request to the E-Waybill API with the following request headers.

This request needs the IDs of E-Waybill that you have generated

#### URL query string:

```
{{HOST}}/v0.1/taxable_entities/{taxable_entity_id}/ewaybill/{id}/multi_vehicle
```

#### Request Parameters:

| Parameters                 | Parameter Type | Type   | Description                                                                                                                                                     |
| -------------------------- | -------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| X-Cleartax-Auth-Token      | Header         | String | Mandatory. The auth token generated from ClearTax user id and password.                                                                                         |
| taxable\_entity\_id        | Path           | String | Required. This is the unique ID associated with the GSTIN in your account.                                                                                      |
| id                         | Path           | String | Required. Unique Transaction ID.                                                                                                                                |
| Source                     | Path           | String | USER, GOVERNMENT, TRANSPORTER, ACTIVE\_EWB                                                                                                                      |
| transport\_mode            | Body           | String | Mandatory.  ROAD, RAIL, AIR, SHIP, IN\_TRANSIT                                                                                                                  |
| from\_place                | Body           | String | Mandatory.                                                                                                                                                      |
| quantity                   | Body           | String | Mandatory.                                                                                                                                                      |
| unit\_of\_measurement      | Body           | String | Mandatory.  Refer [unit master](https://cleartax.gitbook.io/cleartax-for-developers/gst-api/gst-api-reference/resources-and-masters/unit-of-measurement-master) |
| update\_reason             | Body           | String | Mandatory. BREAKDOWN, 'RANSHIPMENT, OTHERS, FIRST\_TIME                                                                                                         |
| remarks                    | Body           | String | Mandatory.                                                                                                                                                      |
| ewb\_client\_id            | Body           | String | Mandatory.  ID of the original E waybill                                                                                                                        |
| to\_place                  | Body           | String | Mandatory.                                                                                                                                                      |
| to\_state                  | Body           | String | Mandatory.                                                                                                                                                      |
| to\_state                  | Body           | String | Mandatory.                                                                                                                                                      |
| transporter\_history\_dtos | Body           | List   | Vehicle details are updated here                                                                                                                                |
| group\_number              | Body           | String | You can add multiple vehicle in a group and you can also add multiple groups                                                                                    |

#### Sample Request:

```
https://ewbbackend-preprodpub-http.internal.cleartax.co/gst/v0.1/taxable_entities/bf557750-936e-4209-ac46-f3e8426d4780/ewaybill/123456123/multi_vehicle
```

#### Sample Payload

```javascript
{
    "group_number": 0,
    "owner": "bf557750-936e-4209-ac46-f3e8426d4780",
    "transport_mode": "ROAD",
    "from_place": "Hosur",
    "from_state": "Tamil Nadu",
    "quantity": "82",
    "unit_of_measurement": "BOX",
    "update_reason": "TRANSHIPMENT",
    "remarks": "no remark",
    "ewb_client_id": "tes123",
    "to_place": "Bangalore",
    "to_state": "Karnataka",
    "transporter_history_dtos": [
        {
            "id": "tes123",
            "group_number": 1,
            "owner": "bf557750-936e-4209-ac46-f3e8426d4780",
            "transport_mode": "ROAD",
            "from_place": "Hosur",
            "from_state": "TAMILNADU",
            "quantity": "82",
            "unit_of_measurement": "BOX",
            "update_reason": "TRANSHIPMENT",
            "remarks": "no remark",
            "transport_history_state": "SYNCED_WITH_GOVT",
            "transporter_gstin": "29AAACW6288M1ZH",
            "transporter_name": null,
            "transport_doc_number": "12345",
            "transport_date": "2020-06-12",
            "vehicle_number": "tn70ab6565",
            "vehicle_type": null,
            "entered_by_gstin": "",
            "entered_on": "",
            "cewb_number": null,
            "is_cancelled": false
        }
    ]
}
```

{% hint style="success" %}
You will get an empty response if multi vehicle is successfully updated
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cleartax.in/cleartax-docs/e-waybill-api/e-waybill-api-reference/e-waybill-json-api-reference/multi-vehicle-e-waybill.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.