Querying

The query endpoint is:

POST /api/v1/datasets/{name}/query
Content-Type: application/json

For one-request Arrow IPC exports, use:

POST /api/v1/datasets/{name}/query/stream
Content-Type: application/json

The legacy un-versioned alias POST /api/datasets/{name}/query is also mounted and behaves identically. The stream endpoint is also available under POST /api/datasets/{name}/query/stream.

Pages

• Request body — every field, in one table.
• Projection & pagination — columns, page, page_size, limit.
• Predicates — all eleven operators.
• Sorting & limit — order_by, hard caps.
• Grouping & aggregation — group_by + aggregations.
• Distinct — distinct: true.
• Arrow IPC vs JSON — paged Arrow responses and full-result streams.
• Counting — POST /count shape.
• Recipes — end-to-end queries combining every feature.