> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Request a campaign data export

> Queues an asynchronous export of the campaign's call history or survey responses as CSV or XLSX and returns immediately with a job handle — nothing is generated during the request. Poll the job with the export-status call.

When the job completes, fetch the file through the export-download call, which mints a pre-signed link; the same link is also emailed to the requester. Optional `filters` narrow the export by contact, agent or date range — omit them to export everything for the campaign.

The call is not idempotent: every request enqueues a new job, so a retry after a timeout creates a second export and a second link. There is no deduplication window or idempotency key.

`filters.contactId` and `filters.userId` must be positive ids, and `dateFrom` / `dateTo` must be strict ISO 8601 — anything else is a 400 and no job is enqueued. Supplying only one bound is valid: a missing `dateTo` resolves to the time the job runs, a missing `dateFrom` to the campaign's creation. Each bound you do supply must itself be parseable as a date-time — strict ISO 8601 admits forms such as the week date `2026-W33` that cannot be read, and such a bound returns 422 (`dateFrom must be a parseable ISO 8601 date-time`, or the `dateTo` equivalent) whether or not the other bound is present. Supplying both with a `dateTo` that is not after `dateFrom` returns 422 (`dateTo must be after dateFrom`), and again nothing is enqueued.

<Warning>The Dialer is a newly released product surface: depending on your account's rollout stage, campaigns managed through this API may not yet be visible in your CloudTalk Dashboard.</Warning>


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://developers.cloudtalk.io/llms.txt).


## Related topics

- [Changelog](/changelog.md)
- [CloudTalk API Response Envelope Formats and Schema](/guides/response-envelopes.md)
- [Get an export job's status](/api-reference/dialer/get-an-export-jobs-status.md)