GET · Signed URL; no API key

Download results with a signed link

Download the exact saved list version from a download_url returned by get-task.

Set up with your AI assistant

Paste the prompt into your coding assistant. It includes setup steps and a read-only connection check.

Request

Endpoint

GET https://leadsagent.io/api/v1/downloads/{token}

Use the signed download link from the task. The link needs no API-key header and expires after one hour.

Bash · API base URL

export LEADSAGENT_API_BASE="https://leadsagent.io/api/v1"
# For a local backend:
# export LEADSAGENT_API_BASE="http://127.0.0.1:8001/api/v1"

Bash · curl

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

Replace TASK_ID with data.id from a task response. In PowerShell, use curl.exe and $env:LEADSAGENT_API_KEY. Save JSON in a file and pass --data-binary @request.json.

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

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.

Response

HTTP 200 file stream. The default is CSV; choose json for a JSON array.

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]

Errors and retries explains status codes and retry rules. A successful request does not mean a background task has finished.

Read as Markdown