Get a download link for a completed export
Mints a fresh pre-signed S3 link for a completed export job and returns it in a JSON body together with the instant it expires. This is deliberately not a redirect and not a file stream: the body lets a machine consumer read the expiry, and HTTP clients that strip credentials on redirects cannot misbehave.
Every call mints a new link, so the call is idempotent and repeatable — when a link expires, call again for a fresh one. Links live at least 60 minutes. The job itself never expires; only individual links do. The same link is also emailed to the requester when the job completes.
A job that is still queued or running answers 409 (keep polling the export-status call); a failed job answers 409 with a message saying no file exists (terminal — stop polling). A job belonging to another company reads as 404.
Authorizations
HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).
Path Parameters
Export job ID returned by the export enqueue call.
Response
A fresh download link and its expiry.
A pre-signed download link for a completed export. Minted fresh on every call; valid at least 60 minutes.
Pre-signed S3 URL of the export file. Fetch it without credentials — the signature is the authorization.
"https://ct-dialer-exports.s3.eu-west-1.amazonaws.com/exports/700001/0197fbd1-6d0a-7e58-8f6f-1a2b3c4d5e6f/call_history-campaign-42.csv?X-Amz-Signature=…"
Instant the URL stops working (ISO 8601, UTC). Call the endpoint again for a fresh link.
"2026-08-04T09:05:00.000Z"