---
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[]
  - union
    - 'FAILED'
    - 'QUOTA_EXCEEDED'
    - 'INTERNAL_ERROR'
    - 'PAUSED'
    - 'RUNNING'
    - 'STOPPED'
    - 'SUCCEEDED'
    - 'MEMORY_LIMIT_EXCEEDED'
    - 'TIMEOUT'
- `limit` number
- `cursor` string
- `createdAfter` string
- `createdBefore` string
- `projectId` string, required

## 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
    - `logsFileId` string, nullable
    - `tasks` number
    - `status` union, required
      - 'FAILED'
      - 'QUOTA_EXCEEDED'
      - 'INTERNAL_ERROR'
      - 'PAUSED'
      - 'RUNNING'
      - 'STOPPED'
      - 'SUCCEEDED'
      - 'MEMORY_LIMIT_EXCEEDED'
      - 'TIMEOUT'
    - `duration` number
    - `startTime` string, required
    - `finishTime` string
    - `environment` union, required
      - 'PRODUCTION'
      - 'TESTING'
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2025-01-09** `b6ee827ed6ef` — 1 info
  - added `subschema #8` to the `data/items/status` response property `anyOf` list for the response status `200`
- **2024-11-12** `499ae054e9e9` — 1 breaking
  - the `query` request parameter `projectId` became required
- **2024-09-13** `225ff954244e` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2024-09-09** `b04deb48df4b` — 1 info
  - added the optional property `data/items/logsFileId` to the response with the `200` status
- **2024-08-15** `cc03cf1422f9` — 2 info
  - removed the pattern `^[0-9a-zA-Z]{21}$` from the `query` request parameter `flowId`
  - for the `query` request parameter `flowId`, the type/format was generalized from `string`/`` to `array`/``

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

---

[API](https://skmtc.dev/activeboxes/apis/activeboxes-documentation.md) · [All operations](https://skmtc.dev/activeboxes/apis/activeboxes-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/activeboxes/activeboxes-documentation/revisions/12c564515962/schema)