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

# GET /v1/flows/

`GET /v1/flows/`

List flows

## Query parameters

- `folderId` string
- `limit` number
- `cursor` string
- `status` union
  - 'ENABLED'
  - 'DISABLED'
- `projectId` string, required

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `created` string, required
    - `updated` string, required
    - `projectId` string, required
    - `folderId` string, nullable
    - `status` union, required
      - 'ENABLED'
      - 'DISABLED'
    - `schedule` object, nullable
      - `type` 'CRON_EXPRESSION', required
      - `cronExpression` string, required
      - `timezone` string, required
    - `publishedVersionId` string, nullable
    - `version` object, required
      - `id` string, required
      - `created` string, required
      - `updated` string, required
      - `flowId` string, required
      - `displayName` string, required
      - `trigger` union, required
        - object
          - `name` string, required
          - `valid` boolean, required
          - `displayName` string, required
          - `nextAction` unknown
          - `type` 'WEBHOOK', required
          - `settings` object, required
            - `inputUiInfo` object, required
              - …
        - object
          - `name` string, required
          - `valid` boolean, required
          - `displayName` string, required
          - `nextAction` unknown
          - `type` 'PIECE_TRIGGER', required
          - `settings` object, required
            - `pieceName` string, required
            - `pieceVersion` string, required
            - `pieceType` union, required
              - …
            - `packageType` union, required
              - …
            - `triggerName` string, required
            - `input` object, required
            - `inputUiInfo` object, required
              - …
        - object
          - `name` string, required
          - `valid` boolean, required
          - `displayName` string, required
          - `nextAction` unknown
          - `type` 'EMPTY', required
          - `settings` unknown, required
      - `updatedBy` string, nullable
      - `valid` boolean, required
      - `state` union, required
        - 'LOCKED'
        - 'DRAFT'
  - `next` string, nullable — Cursor to the next page
  - `previous` string, nullable — Cursor to the previous page

## Changes

- **2024-01-09** `75238cf28038` — 1 info
  - endpoint added
- **2024-01-09** `f3f87594440b` — 1 breaking
  - api path removed without deprecation
- **2024-01-08** `888e937e184a` — 1 info
  - endpoint added
- **2023-12-05** `03ab7a3a2af9` — 1 breaking
  - api path removed without deprecation
- **2023-12-03** `7b0cc60eed56` — 3 warning, 2 info
  - deleted the `query` request parameter `projectId`
  - deleted the `query` request parameter `status`
  - removed the optional property `data/items/publishedVersionId` from the response with the `200` status
  - added `subschema #3` to the `data/items/status` response property `anyOf` list for the response status `200`
  - …1 more

[Change history](https://skmtc.dev/tookey-io/apis/activepieces-documentation/changes/v1/flows/get.md)

---

[API](https://skmtc.dev/tookey-io/apis/activepieces-documentation.md) · [All operations](https://skmtc.dev/tookey-io/apis/activepieces-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tookey-io/activepieces-documentation/revisions/47ba6f96910d/schema)