/api/v1/exportsBulk export
Ask for a date range of events or people as one gzip JSONL file, then poll the job for a signed download link.
For a backfill or a one-off copy. The file is written in the background, so the request returns a job straight away. The same button is in Dashboard → Settings → Exports → Bulk export.
Authorization
Authorization: Bearer fk_data_… with the events:read scope, or a dashboard session with x-app-id.
Create a job
What to export. Events are picked by their timestamp, persons by when the person was created.
First day included, in UTC.
Last day included, in UTC. At most 366 days after date_from.
One JSON object per line, gzip-compressed. The only format today, so it can be left out.
curl -X POST https://api.fictura.co/api/v1/exports \
-H "Authorization: Bearer fk_data_..." \
-H "Content-Type: application/json" \
-d '{"kind":"events","date_from":"2026-09-01","date_to":"2026-09-30","format":"jsonl"}'{
"ok": true,
"export": {
"id": "c3d4e5f6-…",
"kind": "events",
"format": "jsonl",
"status": "queued",
"date_from": "2026-09-01",
"date_to": "2026-09-30",
"rows": null,
"bytes": null,
"url": null,
"expires_at": null,
"expired": false,
"error": null,
"created_at": "2026-10-09T12:00:00.000Z",
"started_at": null,
"finished_at": null
}
}The response repeats the job's fields at the top level, next to export. A bad body answers 400 invalid_body with issues, a bad range 400 invalid_range with message, and a server with no file storage 503 storage_not_configured.
Poll the job
GET /api/v1/exports/:id until status is done or failed (it starts queued, then running). Wait a few seconds between calls and back off on long jobs. A failed job says why in error. GET /api/v1/exports lists the app's last 20 jobs under exports.
{
"ok": true,
"export": {
"id": "c3d4e5f6-…",
"kind": "events",
"format": "jsonl",
"status": "done",
"date_from": "2026-09-01",
"date_to": "2026-09-30",
"rows": 182044,
"bytes": 20817455,
"url": "https://…/exports/c3d4e5f6.jsonl.gz?token=…",
"expires_at": "2026-10-09T13:00:00.000Z",
"expired": false,
"error": null,
"created_at": "2026-10-09T12:00:00.000Z",
"started_at": "2026-10-09T12:00:01.000Z",
"finished_at": "2026-10-09T12:03:12.000Z"
}
}url is a signed link, minted fresh on each poll and good for an hour (expires_at). The file is kept for 7 days; after that expired is true and url is null. Each line has the same shape as one row of the Events API or Persons API.
Files are written to Fictura's exports storage bucket. On a self-run development backend without storage, they go to local disk.
Newer backends only
On a Fictura backend that predates bulk export, POST /api/v1/exports answers 404 and the dashboard hides the Bulk export panel.