passage

CSV exports

POST /v1/exports returns the raw events in a date range as CSV.

POST /v1/exports with {"from": "2026-10-01", "to": "2026-11-01"} returns the raw events in that range as CSV (RFC 4180): one row per event, with columns customer_id, event_name, timestamp, properties. Add customer_id to export one customer.

Limits today

Exports run in a single request. On large accounts, ranges over about 30 days can time out after 60 seconds. Until streaming exports ship (target 2026-11-20), split long ranges into 30-day windows.

Format notes

  • Timestamps are UTC, RFC 3339.
  • properties is a JSON object in one quoted column.
  • Our proposed usage-export format is described in the draft spec.

Links on this page