Actions47
- Account Actions
- Chat Actions
- Contact Actions
- Group Actions
- Location Actions
- Message Actions
- Number Actions
- Phone Number Actions
- Poll Actions
- Reaction Actions
- Typing Indicator Actions
- Webhook Actions
Message → List
AI-generatedSummary
Retrieves a paginated list of messages within a specified conversation, filtered by direction, timestamps, and sorting order.
Inputs
- chatId (required) — The conversation to target. Can be a phone number in E.164 format (e.g. +15551234567), an email address, a group ID (grp_xxx), or a comma-separated list of phone numbers/emails for a multi-recipient chat.
- limit — Max number of results to return (1-200).
- listFilters — A collection of filters including Direction (inbound/outbound), Offset, Since/Until (Unix timestamps in ms), and Sort (desc/asc).
- requestOptions — Advanced request options including Batching (size/interval), Timeout, Proxy, and SSL verification settings.
Output shape
a list of items, each containing message details.
Filters apply to the API query. Pagination is supported via the offset and limit parameters.
Examples
Example 1: Fetch the most recent 10 inbound messages for a specific phone number.
chatId: +15551234567, limit: 10, listFilters.direction: inbound, listFilters.sort: desc
Example 2: Retrieve messages sent after January 1st, 2024 (1704067200000) up to a specific timestamp.
listFilters.since: 1704067200000, listFilters.until: 1712073599999