# Download results with a signed link
Download the exact saved list version from a download_url returned by get-task.
**Request:** `GET https://leadsagent.io/api/v1/downloads/{token}?format=csv`
**Access:** Signed URL; no API key.
**Response:** HTTP 200 file stream. The default is CSV; choose json for a JSON array.

## Parameters

- `token` (signed path token): Required. Copy the complete token from download_url.
- `format` (string): Optional. csv (default) or json.

## cURL

```sh
curl --fail-with-body --silent --show-error --request GET "$LEADSAGENT_API_BASE/downloads/$DOWNLOAD_TOKEN?format=csv"
```

## Example response

```
HTTP/1.1 200 OK
Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="leads-{task_id}.csv"

[CSV file body omitted]
```

## Notes

- This signed link needs no API key and expires after one hour.
- Anyone who obtains the link can download its list until it expires. Treat the URL as a secret: do not log it or forward it to people who should not see the list.

[Open the full API reference](https://leadsagent.io/documentation/api-reference)