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

# Exports

> Asynchronous data exports (customers, events, purchases)

The **Exports API** creates asynchronous jobs that produce CSV/JSON dumps of large resources — customers, events, purchases — filtered by date range and optional segments. Exports run in the background and notify via polling on the export status endpoint.

## Key concepts

* **Job lifecycle** — newly created jobs return as `New`, transition to `Processing` when a worker picks them up, then settle on `Done` (success) or `Failed` (error). The status string is reported by the upstream task system; treat unrecognised values as forward-compatibility fallbacks.
* **History** — `/v4/exports/history` lists previous export jobs with signed download URLs once completed.
* **Polling** — `GET /v4/exports/{export_id}` returns current status and download URL when ready.

## Available endpoints

| Method | Endpoint               | Description           | Status |
| ------ | ---------------------- | --------------------- | ------ |
| POST   | `/exports`             | Create export (async) | New    |
| GET    | `/exports/history`     | List past exports     | New    |
| GET    | `/exports/{export_id}` | Get export status     | New    |

## Authentication

All v4 endpoints require a **Secret Key**. See [Authentication](/reference/v4/authentication).