---
title: "Get recent runs of a workflow"
method: GET
path: "/insights/{project-slug}/workflows/{workflow-name}"
tags: ["Insights"]
---

# Get recent runs of a workflow

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

Get recent runs of a workflow. Runs going back at most 90 days are returned. 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
- `workflow-name` string, required

## Query parameters

- `all-branches` boolean
- `branch` string
- `page-token` string
- `start-date` string, date-time
- `end-date` string, date-time

## Response `200`

A paginated list of recent workflow runs

- object — Paginated recent workflow runs.
  - `items` object[], required — Recent workflow runs.
    - `id` string, uuid, required — The unique ID of the workflow.
    - `branch` string, required — The VCS branch of a Workflow's trigger.
    - `duration` integer, required — The duration in seconds of a run.
    - `created_at` string, date-time, required — The date and time the workflow was created.
    - `stopped_at` string, date-time, required — The date and time the workflow stopped.
    - `credits_used` integer, required — The number of credits used during execution. Note that Insights is not a real time financial reporting tool and should not be used for credit reporting.
    - `status` 'success' | 'failed' | 'error' | 'canceled' | 'unauthorized', required — Workflow status.
    - `is_approval` boolean, required — Describes if the job is an approval job or not. Approval jobs are intermediary jobs that are created to pause the workflow until approved.
  - `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)