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

# List flows

`GET /v1/flows`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/flows`
- Auth: API key in header `Authorization`

List your flows

## Response `200`

A successful response.

- V1ListFlowsResponse
  - `flows` Flowv1Flow[]
    - `id` string
    - `name` string
    - `steps` V1Step[]
      - `id` string
      - `name` string
      - `options` V1StepOptions
        - `skippable` boolean
    - `options` V1FlowOptions
      - `runCreditCheck` V1RunCreditCheck
        - `provider` string[]

## Other responses

- `default`: An unexpected error response.

## Changes

- **2025-06-03** `d073d48df6b1`: 1 info
  - added the optional property `flows/items/options` to the response with the `200` status
- **2025-02-03** `ab4f2018e446`: 1 info
  - endpoint added
- **2025-02-03** `d22701eae819`: 1 breaking
  - api path removed without deprecation
- **2025-02-03** `ab4f2018e446`: 1 info
  - endpoint added
- **2025-02-02** `67b7e6175415`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/changes/v1/flows/get.md)

---

[API](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto.md) - [All operations](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/llms.txt) - [OpenAPI document](https://skmtc.dev/getcove/apis/proto-screening-v2-screening-proto/revisions/9d9f9d9f0188?raw)