---
title: "GET /v1/flow-runs/"
method: GET
path: "/v1/flow-runs/"
tags: ["flow-runs"]
---

# GET /v1/flow-runs/

`GET /v1/flow-runs/`

List Flow Runs

## Query parameters

- `flowId` string
- `tags` string[]
- `status` union
  - 'FAILED'
  - 'QUOTA_EXCEEDED'
  - 'INTERNAL_ERROR'
  - 'PAUSED'
  - 'RUNNING'
  - 'STOPPED'
  - 'SUCCEEDED'
  - 'TIMEOUT'
- `limit` number
- `cursor` string
- `createdAfter` string
- `createdBefore` string
- `projectId` string

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `projectId` string, required
    - `flowId` string, required
    - `tags` string[]
    - `flowVersionId` string, required
    - `flowDisplayName` string, required
    - `tasks` number
    - `status` union, required
      - 'FAILED'
      - 'QUOTA_EXCEEDED'
      - 'INTERNAL_ERROR'
      - 'PAUSED'
      - 'RUNNING'
      - 'STOPPED'
      - 'SUCCEEDED'
      - 'TIMEOUT'
    - `duration` number
    - `startTime` string, required
    - `finishTime` string, required
    - `environment` union, required
      - 'PRODUCTION'
      - 'TESTING'
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2024-06-11** `a1d1c2fbc615` — 1 info
  - added the optional property `data/items/duration` to the response with the `200` status
- **2024-03-04** `7d2c62096ae1` — 1 info
  - endpoint added
- **2023-12-03** `7b0cc60eed56` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/rantirai/apis/activepieces-documentation/changes/v1/flow-runs/get.md)

---

[API](https://skmtc.dev/rantirai/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/rantirai/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/rantirai/apis/activepieces-documentation/revisions/a1d1c2fbc615?raw)