v5
latestOpenAPI 3.1.02026-08-081,0211,3082.1 MBQUERIES_V2
Get Task Runs
Individual runs of one Snowflake task (the drill-down opened when a task name is clicked), read from snowflake_task_history and filtered to the qualified (database_name, schema_name, name) triple. Summed metrics live on /tasks/list; this returns one row per run with derived per-run durations.
The optional repeatable states query param narrows the per-run table to the given run states (e.g. ?states=FAILED&states=EXECUTING); absent or empty means "all states".
get/query/v2/tasks/runs
Query parameters
database_namestring required
schema_namestring required
namestring required
pageinteger
Page number
Page number
sizeinteger
Page size
Page size
sortAttributestring nullable
sortOrderstring nullable
start_datestring date-time nullable
end_datestring date-time nullable
statesstring[] nullable
navigationSourcestring nullable
Headers
x-tenantstring required
Response
Successful Response