List Messages
senderkit_messages_listList sent and scheduled messages across email, SMS, push, and web-push. Filter by channel, template, delivery status, or metadata — use this to monitor deliverability, debug failed sends, or audit transactional message history.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max messages to return, 1-200 (default 50). | |
| cursor | No | Pagination cursor. | |
| search | No | Case-insensitive substring search over public id, recipient, template slug, and metadata keys/values. Composes with the other filters; use metadata for an exact match. Max 512 characters. | |
| status | No | Filter by lifecycle status: scheduled, queued, rendered, dispatched, sent, delivered, failed, opted_out, suppressed, blocked, canceled. | |
| channel | No | Filter by channel. | |
| context | Yes | Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): "Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization." | |
| metadata | No | Filter by metadata (each key/value must match). | |
| template | No | Filter by template slug. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | Messages, newest first. | |
| nextCursor | Yes | Pass as `cursor` to fetch the next page; null when there are no more. |