Returns the workspace's SMS messages as a cursor-paginated list, newest first. Filter by direction, status, category, recipient, sender, failure reason, 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 an SMS message](/docs/api/reference/get-sms-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 direction. Omit for both. Possible values: `outbound`, `inbound` Keep only messages whose current `status` matches; repeat the parameter to match any of several. One of `scheduled`, `accepted`, `sent`, `delivered`, `undelivered`, `failed`, `rejected`, `canceled`, `expired`, or `received`. Keep only messages whose failure reason (`last_error.code`) matches; repeat the parameter to match any of several. One of `invalid_destination`, `unreachable`, `blocked_by_carrier`, `blocked_by_recipient`, `landline_unreachable`, `content_rejected`, `sender_unregistered`, `recipient_opted_out`, `provider_unavailable`, `insufficient_balance`, or `unknown`. Filter by category. Possible values: `transactional`, `marketing`, `authentication`, `service` Filter by recipient phone number (E.164 exact match). Filter by sender (E.164, alphanumeric, or short code; exact match). 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 SMS messages, newest first. ID of the message (`sms_`-prefixed), assigned when the send is accepted. Pass it as `message_id` to the get-message endpoint. Whether the message was sent from a Bird sender (`outbound`) or received from a subscriber (`inbound`). Possible values: `outbound`, `inbound` Recipient phone number in E.164 format. Sender the message was sent from: an E.164 number, an alphanumeric sender ID, or a short code. The message body as sent. For a template send, this is the rendered text after parameter substitution. Content classification supplied on the send. Null for inbound messages. Segment breakdown for the body. Number of segments the body is split into. Each segment is a billable unit. Encoding used for the body. `GSM_7BIT` fits 160 characters in a single segment (153 per part when multi-segment); `UCS2` is used when the body contains any character outside the GSM 03.38 alphabet (emoji, CJK, some accented characters) and fits 70 characters in a single segment (67 per part when multi-segment). Possible values: `GSM_7BIT`, `UCS2` Character count of the body under the selected encoding. Cost of the message. Null until the message has been priced. ISO 4217 currency code for the cost amount. Omitted when the cost is not denominated in a currency (for example a zero-priced internal send). Total cost as a decimal string: the per-segment rate multiplied by the segment count, plus any surcharges. Per-component cost breakdown. Returned on single-message reads; omitted from list rows. Per-segment price as a decimal string. Number of billable segments. ISO 3166-1 alpha-2 destination country the price was resolved for. Carrier surcharge component as a decimal string (for example US 10DLC fees). `0.0000` when none applies. 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 and echoed in webhook payloads. How long, in seconds, Bird keeps trying to deliver before the message transitions to `expired`. Carrier that handled the message, when known. Populated once a delivery receipt identifies it. Mobile country code and mobile network code of the carrier, when known. Failure detail on a terminally failed or rejected message. Present only when the message failed. Bird-stable failure reason. `invalid_destination`: the number is not assigned, ported out, or malformed. `unreachable`: handset off or out of coverage. `blocked_by_carrier`: the carrier filtered the message. `blocked_by_recipient`: the recipient device blocked the sender. `landline_unreachable`: the destination is a landline that does not accept SMS. `content_rejected`: the carrier rejected the content. `sender_unregistered`: the sender is not registered for the destination. `recipient_opted_out`: the recipient is on a suppression list. `provider_unavailable`: an upstream failure after retries. `insufficient_balance`: the workspace wallet had insufficient balance to send the message. `unknown`: an unmapped failure. Possible values: `invalid_destination`, `unreachable`, `blocked_by_carrier`, `blocked_by_recipient`, `landline_unreachable`, `content_rejected`, `sender_unregistered`, `recipient_opted_out`, `provider_unavailable`, `insufficient_balance`, `unknown` Human-readable explanation of the failure. Raw carrier-supplied error code, when available, for low-level debugging. When the failure occurred. When the message was accepted (outbound) or received (inbound). When the message was handed to the carrier. Null until then. When delivery was confirmed. Null until then. 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`.