---
title: "Get summary metrics for a project's workflows"
method: GET
path: "/insights/{project-slug}/workflows"
tags: ["Insights"]
---

# Get summary metrics for a project's workflows

`GET /insights/{project-slug}/workflows`

Get summary metrics for a project's workflows.  Workflow runs going back at most 90 days are included in the aggregation window. Metrics are refreshed daily, and thus may not include executions from the last 24 hours.  Please note that Insights is not a financial reporting tool and should not be used for precise credit reporting.  Credit reporting from Insights does not use the same source of truth as the billing information that is found in the Plan Overview page in the CircleCI UI, nor does the underlying data have the same data accuracy guarantees as the billing information in the CircleCI UI.  This may lead to discrepancies between credits reported from Insights and the billing information in the Plan Overview page of the CircleCI UI.  For precise credit reporting, always use the Plan Overview page in the CircleCI UI.

## Path parameters

- `project-slug` string, required

## Query parameters

- `page-token` string
- `all-branches` boolean
- `branch` string
- `reporting-window` 'last-7-days' | 'last-90-days' | 'last-24-hours' | 'last-30-days' | 'last-60-days'

## Response `200`

A paginated list of summary metrics by workflow

- object — Paginated workflow summary metrics.
  - `items` object[], required — Workflow summary metrics.
    - `name` string, required — The name of the workflow.
    - `metrics` object, required — Metrics relating to a workflow's runs.
      - `total_runs` integer, required — The total number of runs, including runs that are still on-hold or running.
      - `successful_runs` integer, required — The number of successful runs.
      - `mttr` integer, required — The mean time to recovery (mean time between failures and their next success) in seconds.
      - `total_credits_used` integer, required — The total credits consumed by the workflow in the aggregation window. Note that Insights is not a real time financial reporting tool and should not be used for credit reporting.
      - `failed_runs` integer, required — The number of failed runs.
      - `success_rate` number, float, required
      - `duration_metrics` object, required — Metrics relating to the duration of runs for a workflow.
        - `min` integer, required — The minimum duration, in seconds, among a group of runs.
        - `mean` integer, required — The mean duration, in seconds, among a group of runs.
        - `median` integer, required — The median duration, in seconds, among a group of runs.
        - `p95` integer, required — The 95th percentile duration, in seconds, among a group of runs.
        - `max` integer, required — The max duration, in seconds, among a group of runs.
        - `standard_deviation` number, float, required — The standard deviation, in seconds, among a group of runs.
      - `total_recoveries` integer, required — The number of recovered workflow executions per day.
      - `throughput` number, float, required — The average number of runs per day.
    - `window_start` string, date-time, required — The timestamp of the first build within the requested reporting window.
    - `window_end` string, date-time, required — The timestamp of the last build within the requested reporting window.
    - `project_id` unknown, required
  - `next_page_token` string, required — A token to pass as a `page-token` query parameter to return the next page of results.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/circleci/apis/api-v2.md) · [All operations](https://skmtc.net/circleci/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/circleci/api-v2/revisions/b9c0e0c24058/schema)