Get Email
GET /v1/emails/:idRetrieves a previously sent email, including its current status and the full event timeline.
Example
Node.js
const { data, error } = await retransmit.emails.get("em_xxxxxxxxxxxx");Response
200 OK
{
"id": "em_xxxxxxxxxxxx",
"batch_id": null,
"from": "Acme <hello@yourdomain.com>",
"to": ["user@example.com"],
"cc": null,
"bcc": null,
"reply_to": null,
"subject": "Your receipt",
"status": "delivered",
"error": null,
"created_at": "2026-09-01T12:00:00.000Z",
"last_event_at": "2026-09-01T12:00:03.000Z",
"events": [
{ "type": "email.sent", "created_at": "2026-09-01T12:00:01.000Z" },
{ "type": "email.delivered", "created_at": "2026-09-01T12:00:03.000Z" }
]
}Email statuses
| Status | Meaning |
|---|---|
queued | Accepted and waiting for the worker; also the state while sends are being retried. |
scheduled | Scheduled for a later send. |
sent | Handed to the upstream provider. |
delivery_delayed | The receiving server temporarily deferred delivery. |
delivered | Accepted by the recipient’s mail server. |
opened | The recipient opened the email. |
clicked | The recipient clicked a link. |
bounced | The recipient’s server permanently rejected it. |
complained | The recipient marked it as spam. |
suppressed | Not sent — the address is on a suppression list. |
canceled | A scheduled send was canceled. |
rejected | Rejected before sending. |
failed | The send failed after all retries (dead-lettered); error contains the reason. |
Errors
| Status | Code | Cause |
|---|---|---|
404 | not_found | No email with this id on your account. |
401 | unauthorized | Missing, malformed, or revoked API key. |
Last updated on