Skip to main content

Query Run Results Endpoint

POST 
/runs/:run_id/results/query

Filter and sort wide per-row results by metrics, run columns, and dataset dimensions.

Filters use a flat AND and namespaced columns (metric:<name>, column:<run column>, or dimension:<qualified-id>). Dimensions are resolved against the exact dataset version scored by the run and joined on its registered business-row identity. Derived and assigned selections may pin their definition version so the query cannot silently use a newer definition than the UI displayed; a column: reference needs neither selection nor pin, reading the run artifact itself. The three namespaces cover the three origins one group_by value can have, so a charted category becomes its rows without the caller knowing which origin it came from.

Returns 404 if the run does not exist, or if it has neither completed nor failed with output already written. Returns 422 for an invalid filter/sort/group_by expression or dimension data that fails to validate against the run's scored rows, and 424 if a referenced dataset dimension's own data is currently unavailable and must be recomputed.

Request​

Responses​

Successful Response