Skip to main content
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

​
Authentication

All v4 endpoints require a Secret Key. See Authentication.