---
title: "Retrieve a list of all Flows."
method: GET
path: "/v2/Flows"
tags: ["StudioV2Flow"]
---

# Retrieve a list of all Flows.

`GET /v2/Flows`

Retrieve a list of all Flows.

## Query parameters

- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `flows` StudioV2Flow[]
    - `sid` string, nullable — The unique string that we created to identify the Flow resource.
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Flow resource.
    - `author_sid` string, nullable — The SID of the User that created or last updated the Flow.
    - `friendly_name` string, nullable — The string that you assigned to describe the Flow.
    - `definition` unknown
    - `status` 'draft' | 'published' — The status of the Flow. Can be: `draft` or `published`.
    - `revision` integer — The latest revision number of the Flow's definition.
    - `commit_message` string, nullable — Description of change made in the revision.
    - `valid` boolean, nullable — Boolean if the flow definition is valid.
    - `errors` unknown[], nullable — List of error in the flow definition.
      - unknown
    - `warnings` unknown[], nullable — List of warnings in the flow definition.
      - unknown
    - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `webhook_url` string, uri, nullable
    - `url` string, uri, nullable — The absolute URL of the resource.
    - `links` object, nullable — The URLs of the Flow's nested resources.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

## Changes

- **2026-03-24** (v2) `cbcd35943890` — 1 info
  - added the optional property `flows/items/author_sid` to the response with the `200` status
- **2025-07-03** (v2) `88ca5d3cb0bb` — 3 breaking
  - the `flows/items/definition` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `flows/items/errors/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - the `flows/items/warnings/items/` response's property type/format changed from `object`/`` to ``/`` for status `200`
- **2025-03-11** (v2) `d6e7767d27a5` — 3 breaking
  - the `flows/items/definition` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `flows/items/errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `flows/items/warnings/items/` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2025-02-20** (v2) `768ec4521280` — 1 breaking
  - for the `query` request parameter `PageSize`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2024-08-26** (v2) `20f88e4a96ce` — 1 info
  - the `revision` response's property default value `0` was added for the status `200`

[Full history](https://skmtc.dev/twilio/apis/twilio-studio/changes/v2/Flows/get.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-studio.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-studio/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/twilio-studio/revisions/c384dd0ef331/schema)