# Download E-waybills by Others

This API can be used to pull the details of the E-way bills generated by 3rd party against your GSTIN.

### Request Method

POST

### Request URL

```
{{HOST}}/einv/other_party_ewb/download
```

### Request Headers

<table><thead><tr><th width="193.33331298828125">Parameter</th><th width="160.66668701171875">Data Type</th><th width="168.33331298828125">Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>X-Cleartax-Auth-Token</td><td>String</td><td>NA</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>String</td><td>NA</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="194">Parameter</th><th width="149">Data Type</th><th width="169.66668701171875">Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>from_date</td><td>String</td><td>The minimum date can be up to three days before the current date (excluded).</td><td>Mandatory. The start date for the documents to be downloaded.</td></tr><tr><td>till_date</td><td>String</td><td>The maximum date can be the current date minus one.</td><td>Mandatory. The end date for the documents to be downloaded.</td></tr></tbody></table>

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

### Sample Request and Response

#### Request&#x20;

```json
{
    "from_date":"02/02/2022",
    "till_date":"02/02/2022"
}
```

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

**HTTP Status Code 200 OK**

```json
{
   "workflow_id": "61fcc328ef10ce2f6ef58e7b",
   "status": "INIT",
   "error_message": null,
   "message": null,
   "total": 0,
   "failed": 0,
   "success": 0
}
```

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

**HTTP Status Code 200 OK**

```json
{
   "message": "Passing date should be within last/latest 3 days, other than current date.",
   "error_group_code": 0,
   "error_id": 0
}
```

### API Validations

Currently there are no known validations for this API.

### API Constraints

The API can pull data up to the current date minus one. The API is restricted by the government to pull just three days of data excluding the current date.

{% hint style="info" %}
This API triggers download activity asynchronously. Make a note of the `workflow_id` to track the status of the downloaded E-Waybills later by calling the [Get E-Waybill Download Status API](get-e-waybill-download-status).
{% endhint %}
