---
title: "List responses of a WhatsApp Flow"
method: GET
path: "/api/public/whatsapp-flows/{flowId}/responses"
tags: ["WhatsApp Flows"]
---

# List responses of a WhatsApp Flow

`GET /api/public/whatsapp-flows/{flowId}/responses`

Retrieve the completed responses of a WhatsApp Flow, filtered by response date (dateFrom/dateTo). When no dates are provided, it defaults to the last 30 days; when only one date is provided, the other bound is left open. Results are ordered by response date descending and paginated with page/pageSize. Note: responded_at reflects the last time the response was updated — normally when the contact completed the flow, but it can move forward if the response is reprocessed internally (e.g. a media retry), in which case the response reappears in a later date window.

## Path parameters

- `flowId` string, required

## Query parameters

- `dateFrom` string, date-time
- `dateTo` string, date-time
- `page` number
- `pageSize` number

## Headers

- `x-api-key` string, required

## Response `200`

Flow responses retrieved successfully.

- object
  - `items` object[]
    - `id` string
    - `form_data` object
    - `status` string
    - `sent_at` string
    - `responded_at` string
    - `contact` object, nullable
      - `id` string
      - `name` string
      - `phone` string
      - `email` string
  - `page` number
  - `pageSize` number
  - `total` number
  - `totalPages` number
  - `hasNextPage` boolean

## Other responses

- `400` — Invalid query parameters.
- `401` — Invalid or missing API key.
- `404` — Flow not found.

---

[API](https://skmtc.net/vambe/apis/vambe-ai-api.md) · [All operations](https://skmtc.net/vambe/apis/vambe-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vambe/vambe-ai-api/revisions/e206709d4be5/schema)