◈ Lumen Data
API DOCUMENTATION

Predictable data.
Explicit boundaries.

Browse the catalogue

GET /api/fixtures?q=events

Search is optional and limited to 120 characters. The response lists fixture metadata, schemas and expected results.

Fetch a page

GET /api/fixtures/pagination?offset=0&limit=20

The envelope contains items, total, next_offset, version and synthetic: true. Offset is 0–1000; limit is 1–100. Stop when next_offset is null. An offset past the end returns an empty page. Order is stable within a release.

Download everything

GET /downloads/orders.csv
GET /downloads/orders.json
GET /manifest.json

Downloads contain all rows. Check exact bytes against the manifest; JSON nulls become empty CSV fields. Read CSV with a parser, not by splitting lines.

Machine-readable documentation

OpenAPI 3.1 · Pagination example · CSV example

Compatibility

The original /api/datasets endpoints continue to serve climate, power and mobility with JSON/CSV pagination.

Limits and errors

Keep below 60 requests per session per minute. Global capacity is bounded. Honor Retry-After on 429 and stop on persistent 503 responses. Invalid parameters return 422; unknown fixtures return 404. URLs are limited to 4 KiB and request bodies to 16 KiB.

Access

Public access is read-only. Administrative access and mutations require explicit operator permission. Browsing this catalogue does not authorize security testing. Do not submit credentials or personal data.