---
title: "Retrieve all flows associated with the current user from the repository"
method: GET
path: "/flows"
tags: ["flows"]
---

# Retrieve all flows associated with the current user from the repository

`GET /flows`

This will only return Flows that are either directly associated with the user, or that are associated with a tenant that the user is also a member of. Requires the 'flows.read' permissions.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter[status]` string
- `filter[type]` string
- `filter[user]` string
- `sort` string
- `search` string

## Response `200`

A list of flows.

- object
  - `data` Flow[]
    - `name` string, required
    - `description` string
    - `tenant` string
    - `graph` FlowGraph, required
      - `nodes` object[] — An array of all components involved in this flow
        - `id` string, required — ID of this node, which will be referenced by edges
        - `componentId` string — The component repository id of the component (e.g. adapter/transformer) to be used in this step.
        - `credentials_id` string — A secret service id of a secret containing credentials for this node.
        - `function` string — The function that the component will be executing.
        - `name` string — Descriptive name of this node
        - `description` string
        - `fields` object — Optional arguments passed on to the component
      - `edges` object[] — An array of edges linking nodes together, determining the order in which nodes are activated
        - `id` string
        - `config` object
          - `condition` string
          - `mapper` object
        - `source` string, required — The source node of this edge, referring to the id field of a node
        - `target` string, required — The target node of this edge, referring to the id field of a node
    - `type` 'ordinary' | 'realtime', required — Flow type
    - `cron` string — A cron string describing the interval at which this flow is run. If unset, the flow uses webhooks instead
    - `owners` Owner[]
      - `id` string, required — External id of the owner
      - `type` string, required — Type to discriminate between user or tenant
    - `id` string, required
    - `status` 'active' | 'inactive' | 'starting' | 'stopping' — Flow status, set automatically in response to start/stop commands
    - `createdAt` string, date-time, required — Timestamp of flow creation
    - `updatedAt` string, date-time, required — Timestamp of most recent flow update
  - `meta` Meta
    - `page` integer — Current page (1-based numbering)
    - `perPage` integer — Number of objects per page
    - `total` integer — Total number of objects
    - `totalPages` integer — Total number of pages

## Changes

- **2022-06-20** `0f542e67a7ab` — 1 info
  - for the `query` request parameter `filter[status]`, the type/format was generalized from `integer`/`` to `string`/``
- **2021-08-19** `72e092d62dd8` — 1 info
  - removed the non-success response with the status `404`
- **2021-08-13** `04c53d143cde` — 1 info
  - added the optional property `data/items/allOf[#/components/schemas/MutableFlow]/tenant` to the response with the `200` status
- **2019-07-29** `e56437a65634` — 1 info
  - added the optional property `data/items/allOf[#/components/schemas/MutableFlow]/graph/nodes/items/credentials_id` to the response with the `200` status
- **2019-05-14** `7130c41550da` — 1 breaking, 1 info
  - removed the required property `data/items/allOf[#/components/schemas/MutableFlow]/graph/nodes/items/command` from the response with the `200` status
  - added the optional property `data/items/allOf[#/components/schemas/MutableFlow]/graph/nodes/items/function` to the response with the `200` status

[Full history](https://skmtc.dev/openintegrationhub/apis/flow-repository/changes/flows/get.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/flow-repository.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/flow-repository/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/flow-repository/revisions/898fa794c6b8/schema)