---
title: "GET /v1/whatsapp/flow/list#id"
method: GET
path: "/v1/whatsapp/flow/list#id"
---

# GET /v1/whatsapp/flow/list#id

`GET /v1/whatsapp/flow/list#id`

Lists all WhatsApp Flows for a WhatsApp Business Account. Returns summary information including Flow ID, name, status, and categories.

## Query parameters

- `id` string, required
- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListWhatsAppFlowsOutput
  - `flows` MetaFlowSummary[], required — A list of Flow summaries.
    - `flowId` string, required — The unique identifier of the Flow assigned by Meta.
    - `flowName` string, required — The name of the Flow.
    - `flowStatus` string, required — The lifecycle status of the Flow (DRAFT, PUBLISHED, DEPRECATED, BLOCKED, or THROTTLED).
    - `flowCategories` MetaFlowCategory[], required — The categories that classify the business purpose of the Flow.
    - `validationErrors` MetaFlowValidationError[], required — A list of validation errors from Meta, if any.
  - `nextToken` string — The token to retrieve the next page of results, if any.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — InvalidParametersException
- `484` — AccessDeniedByMetaException
- `485` — ThrottledRequestException
- `486` — InternalServiceException
- `487` — DependencyException

---

[API](https://skmtc.net/aws/apis/socialmessaging.md) · [All operations](https://skmtc.net/aws/apis/socialmessaging/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/socialmessaging/versions/127e73cd9a15/schema)