---
title: "List Flow Executions"
method: GET
path: "/channel/whatsapp/flow-execution"
tags: ["Flows"]
---

# List Flow Executions

`GET /channel/whatsapp/flow-execution`

## Request

- Base URL: `https://{youraccountname}.api-us1.com/api/3`
- URL: `https://{youraccountname}.api-us1.com/api/3/channel/whatsapp/flow-execution`
- Auth: API key in header `Token`

Lists Flow Executions.

## Query parameters

- `flow` string, uuid
- `flow_version` string, uuid
- `page` integer
- `search` string

## Response `200`

- PaginatedFlowExecutionListList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` FlowExecutionList[], required
    - `status` 'PROCESSING' | 'READY' | 'AWAITING_CONFIRMATION' | 'CONFIRMED' | 'STARTING' | 'RUNNING' | 'COMPLETED' | 'CANCELED': * `PROCESSING` - Processing * `READY` - Ready * `AWAITING_CONFIRMATION` - Awaiting Confirmation * `CONFIRMED` - Confirmed * `STARTING` - Starting * `RUNNING` - Running * `COMPLETED` - Completed * `CANCELED` - Canceled
    - `execute_for` 'FILTERS' | 'LIST' | 'ALL', required: * `FILTERS` - Filters * `LIST` - List * `ALL` - All
    - `id` string, uuid
    - `has_priority` boolean
    - `flow_execution_variables` unknown
    - `start_on` string, date-time, nullable
    - `num_contacts` integer
    - `expired` integer
    - `running` integer
    - `completed` integer
    - `canceled` integer
    - `failed` integer
    - `created_on` string, date-time
    - `avg_completion_time` string
    - `status_reason` string, nullable
    - `status_triggered_by` integer, nullable
    - `status_last_change_on` string, date-time, nullable
    - `created_by` SimpleUser, required
      - `first_name` string
      - `last_name` string
      - `email` string, email, required
      - `id` integer, required
      - `profile_image` string, uri, nullable
      - `role` integer, nullable
    - `flow_version` string, uuid, required

---

[API](https://skmtc.dev/activecampaign/apis/whatsapp-api.md) - [All operations](https://skmtc.dev/activecampaign/apis/whatsapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/activecampaign/apis/whatsapp-api/revisions/6c7855d91b4d?raw)