Emails

Get message status

GET
/api/v1/emails/{id}

Returns a message's current status and its provider event timeline. Requires a write-scope key.

Authorization

bearerAuth write
headerAuthorizationBearer <token>

An API key from the dashboard under Settings → API keys, sent as Authorization: Bearer aem_….

Authorization has two independent axes.

The scope is ranked — a key satisfies any requirement at or below its own tier:

  • read — see messages, contacts and metrics. Changes nothing, and cannot send.
  • write — everything read does, plus managing templates, contacts, automations, segments and suppressions. This is what editing a template needs.
  • admin — everything write does, plus sending configuration: domains, senders, webhook registration, kill switch, daily cap, brand.

There is no approve scope. It was a rung once; it is not one now, and a key requested with it is rejected.

The approval grant (can_approve) is a separate boolean, not a rung. Delivering mail to a real inbox needs write and the grant. Keeping them on separate axes is what makes the review gate a control rather than a convention: a key that may propose is not automatically a key that may approve its own proposal.

Give your application the lowest tier that works. Most need write and the grant — the dashboard mints that combination as Send + manage; Manage only is the same rung with the grant withheld.

Scope: write

Path Parameters

id*string

Message id returned by a send.

Response Body

The message and its events.

application/json
  1. response
id?string
to?string
from?string
subject?string
template?string|null
status?string

Latest status on the delivery ladder.

last_event?|

Type of the newest event in events, or null before the first.

source?string
error?string|null
suppressed_reason?string|null
provider?string|null
provider_message_id?string|null
ab_variant?string|null
scheduled_at?|
Formatdate-time
sent_at?|
Formatdate-time
created_at?string
Formatdate-time
events?array<>

Provider events for this message, oldest first (max 100).

Example Request
curl -X GET 'https://sendandretain.com/api/v1/emails/msg_3aF9c1'
Example Response
{  "id": "msg_3aF9c1",  "to": "[email protected]",  "from": "[email protected]",  "subject": "Welcome to Acme",  "template": "welcome",  "status": "delivered",  "source": "api",  "error": null,  "suppressed_reason": null,  "provider": "resend",  "provider_message_id": "re_abc123",  "ab_variant": null,  "scheduled_at": null,  "sent_at": "2026-07-20T14:31:02Z",  "created_at": "2026-07-20T14:31:01Z",  "events": [    {      "type": "sent",      "provider": "resend",      "occurred_at": "2026-07-20T14:31:02Z"    },    {      "type": "delivered",      "provider": "resend",      "occurred_at": "2026-07-20T14:31:05Z"    }  ]}