---
title: "Get Task Runs Summary"
method: GET
path: "/query/v2/tasks/runs_summary"
tags: ["QUERIES_V2"]
---

# Get Task Runs Summary

`GET /query/v2/tasks/runs_summary`

Aggregate (summary cards) for ONE Snowflake task on the task-detail
drill-down. Scoped to the qualified (database_name, schema_name, name)
identity, summed across every warehouse the task ran on. ``start_date`` /
``end_date`` are optional (the UI date picker): when supplied the aggregate
is limited to that range; when omitted it covers the task's full retained
history. Warehouse RBAC is enforced inline; a missing user_group_id on an
RBAC tenant fails closed to a zeroed summary.

## Query parameters

- `database_name` string, required
- `schema_name` string, required
- `name` string, required
- `start_date` string, date-time, nullable
- `end_date` string, date-time, nullable
- `navigationSource` string, nullable

## Headers

- `x-tenant` string, required

## Response `200`

Successful Response

- TaskRunsSummaryResponse — Window aggregate (summary cards) for ONE task on the task-detail page. Sourced from ``snowflake_tasks_aggregated`` and scoped to a single qualified task (``database_name``, ``schema_name``, ``name``), summed across every warehouse the task ran on. Mirrors the stored-procedures ``WorkloadSummaryResponse`` summary-cards shape for the task side. Counts and times default to zero (and ``last_run_date`` to ``None``) when no runs are visible in the window.
  - `database_name` string, required
  - `schema_name` string, required
  - `name` string, required
  - `total_cost` number, required
  - `avg_cost` number, required
  - `run_count` integer, required
  - `success_count` integer, required
  - `failure_count` integer, required
  - `execution_time_ms` number, required
  - `queued_time_ms` number, required
  - `avg_execution_time_ms` number, required
  - `avg_queued_time_ms` number, required
  - `compute_cost` number, required
  - `serverless_cost` number, required
  - `credits_used` number, required
  - `serverless_credits_used` number, required
  - `last_run_date` string, date, nullable

## Other responses

- `400` — Not supported for public user
- `403` — Not supported for public user
- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/50769cbf05d5/schema)