Get email events
get_email_eventsRetrieve every event recorded for one sent email, ordered oldest first, with provider details and cursor pagination so you can inspect exactly what happened to that message.
Instructions
Purpose: read every event recorded for one sent message, oldest first, with the provider detail. NOT for: deciding what to do about a bounce (explain_email) or counting across many messages (get_metrics). Returns: data, has_more, and next_cursor. Each row has type, occurred_at, recipient, detail and provider_message_id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email_id": "<email_id>"
},
"name": "get_email_events"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size (1-200). | |
| cursor | No | next_cursor from the previous page. Omit for the first page. | |
| email_id | Yes | The message id returned by send_email. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | This page of rows. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| has_more | No | True when another page follows. | |
| next_cursor | No | Pass back as cursor for the next page; null on the last page. |