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 — pending → processing → completed | failed.
  • 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

MethodEndpointDescriptionStatus
POST/exportsCreate export (async)New
GET/exports/historyList past exportsNew
GET/exports/{export_id}Get export statusNew

​
Authentication

All v4 endpoints require a Secret Key. See Authentication.