Data Export¶

For large-scale extraction, use the export API rather than paginating through every record yourself.

Requesting an export¶

nimbus exports create --bucket my-first-bucket --format ndjson

Response

{
  "export_id": "exp_01HZX9Y8Z7",
  "status": "pending"
}

Polling for completion¶

nimbus exports get exp_01HZX9Y8Z7

Response (completed)

{
  "export_id": "exp_01HZX9Y8Z7",
  "status": "completed",
  "download_url": "https://exports.nimbus.example.com/exp_01HZX9Y8Z7.ndjson.gz",
  "expires_at": "2026-06-19T12:00:00Z"
}

Download links expire

Export download URLs are valid for 24 hours. Re-request the export status to get a fresh URL if it expires.

Supported formats¶

NDJSONCSVParquet

One JSON object per line — ideal for streaming into another system.

{"name": "record-1", "value": 1}
{"name": "record-2", "value": 2}

Flat fields only; nested objects are JSON-encoded as strings.

name,value
record-1,1
record-2,2

Columnar format, recommended for analytics pipelines reading from S3-compatible storage.