List a flow's sessions
list_whatsapp_flow_sessionsList a flow's sessions. The contacts a flow was sent to, newest first. By default only completed sessions — the submissions — dated by when they were submitted; any other status is dated by when the flow was sent. Test sends from the flow editor are left out unless include_test=true. The list carries no answers. Add include=answers to export them: the real values, sensitive ones included, exactly as the conversation's Reveal answers shows them. Every session revealed this way is recorded in the account's audit log under the calling user, so page through only what you need. Answers are removed after the account's retention window; such a session comes back with answers_purged: true. Administrators only. Requires feature: whatsapp_flows.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. | |
| since | No | Sessions submitted (for `completed`) or sent (otherwise) at or after this moment — an ISO 8601 timestamp, or a date (`YYYY-MM-DD`) for the start of that day. | |
| until | No | Same, at or before this moment; a date means the end of that day. | |
| fields | No | Optional: return only these fields of each record. | |
| status | No | One session status. | completed |
| include | No | `answers` to add each session's submitted answers (audited). | |
| per_page | No | Sessions per page. Values above 100 are treated as 100. | |
| include_test | No | Include sends to test numbers. | |
| whatsapp_flow_id | Yes | ID of the flow |