list_messages
Read-only
List messages you've previously sent. Filter by status, recipient, notification, provider, tags, or tenant.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter by metadata tags | |
| list | No | Filter by list ID | |
| tags | No | Comma-delimited list of tags | |
| event | No | Filter by event ID | |
| cursor | No | For fetching the next page. This is an opaque token — never decode it, edit it, or rebuild it. Pass it back exactly as it appeared in the previous response's cursor field, byte for byte. Omit this entirely when you don't have one from a prior response of this exact call. | |
| status | No | Filter by status (e.g. DELIVERED, UNDELIVERABLE) | |
| traceId | No | Filter by trace ID | |
| archived | No | This NARROWS, it does not widen: true returns ONLY archived messages, excluding every active one. Omit it entirely to search active messages — the default view for a normal delivery question. Setting it true is not the thorough or safe choice; it is a different, much smaller result set. | |
| provider | No | Filter by provider key (e.g. sendgrid, twilio) | |
| messageId | No | Filter by message ID | |
| recipient | No | Filter by recipient user ID | |
| tenant_id | No | Filter by tenant ID | |
| notification | No | Filter by notification ID | |
| enqueued_after | No | ISO 8601 timestamp; only return messages enqueued after this time |