Returns the workspace's WhatsApp messages as a cursor-paginated list, newest first. Filter by status, contact phone number, business-scoped user ID, tag, or creation time; pass the response's `next_cursor` back as `starting_after` to fetch the next page. To follow a single message's delivery, use [Get a WhatsApp message](/docs/api/reference/get-whats-app-message) instead. Maximum number of items to return per page. Cursor from the `next_cursor` field of a previous list response. Returns items immediately after the cursor position in the current sort order. Cursor from the `prev_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. Return only resources created at or after this timestamp (inclusive lower bound). Combine with `created_before` to filter to a time window. RFC 3339 / ISO 8601 with timezone. Return only resources created strictly before this timestamp (exclusive upper bound). Combine with `created_after` to filter to a time window. RFC 3339 / ISO 8601 with timezone. Filter by status. Repeat the parameter to match any of several statuses. Filter by contact phone number (E.164 exact match). Filter by business-scoped user ID (Meta identifier). Filter by tag. Accepts `name` to match any message carrying that tag name, or `name:value` to match a specific tag pair (e.g. `category:welcome`). Repeat the parameter to AND-combine several tag filters. Page of WhatsApp messages, newest first. ID of the message (`wam_`-prefixed), assigned when the send is accepted. Pass it as `message_id` to the get-message and list-events endpoints. Whether the message was sent by the business (`outbound`) or received from the contact (`inbound`). Possible values: `outbound`, `inbound` Sender of the message. On outbound messages, the business number it was sent from; on inbound, the WhatsApp contact. Phone number in E.164 format, when known. Business-scoped user ID, Meta's identifier for the WhatsApp user. Present only on the WhatsApp-user side of the message. Recipient of the message. On outbound messages, the WhatsApp contact; on inbound, the business number. Phone number in E.164 format, when known. Business-scoped user ID, Meta's identifier for the WhatsApp user. Present only on the WhatsApp-user side of the message. The template the message was sent from. For authentication templates the filled-in values are not returned. The template's stable handle (for example `bird_otp`). Content classification applied to messages sent from this template. The language code of the template variant that was sent (for example `en`). The values that filled the template's placeholders. Empty for an authentication template, whose content is never returned. Which part of the template this fills in: `body` for the main text, `button` for a button's variable, `header` for the header. Bird manages header values itself, so a `header` entry supplied on a send is ignored. Possible values (may grow over time): `header`, `body`, `button` The values that fill this part's placeholders, in `{{n}}` placeholder order. The kind of value this parameter carries. `text` is the only kind today. The value substituted into the placeholder, as a plain string. For named-parameter templates: the placeholder this value fills (for example `first_name`). Omit for positional templates. Failure detail for a message that did not reach the recipient. Present only when the message failed. Failure reason, uniform whether the failure happened internally or was reported by the WhatsApp network. `insufficient_balance`: the workspace could not afford the send. `price_not_found`: no price was configured for this destination/template combination. `internal_error`: an unexpected Bird-side failure. `undeliverable`: the recipient could not be reached (for example not on WhatsApp, or the number is invalid). `service_window_expired`: the 24-hour customer care window has closed and a free-form message cannot be sent; send a template instead. `rate_limited`: the send was throttled. `recipient_suppressed`: the recipient is on the workspace's suppression list; the message was rejected before sending. Open enum: new codes may be added over time, so treat any unrecognized value as a future code rather than an error. Possible values (may grow over time): `insufficient_balance`, `price_not_found`, `internal_error`, `undeliverable`, `service_window_expired`, `rate_limited`, `recipient_suppressed` Human-readable explanation of the failure. Raw error code from the WhatsApp Cloud API, when available, for low-level debugging. When the failure occurred. When the message was accepted for delivery. When the message was handed to the WhatsApp network. Null until then. When delivery was confirmed. Null until then. When the message was read by the recipient. Null until then. Structured `{name, value}` filter labels applied to this message. Tag name. ASCII letters, digits, underscore, and hyphen only. Case-sensitive. Maximum 32 characters. Tag value. ASCII letters, digits, underscore, and hyphen only. Case-sensitive. Maximum 64 characters. Arbitrary JSON metadata stored on the message. Cursor for the next page. Pass back as `starting_after` to advance forward. Null when no next page exists. Cursor for the previous page. Pass back as `ending_before` to step backward. Null when no previous page exists. Refresh anchor. Pass back as `ending_before` later to fetch items that have appeared since this response. Non-null whenever `data` is non-empty; null only on an empty page. Distinct from `prev_cursor`.