Skip to Content
API ReferenceGet Email

Get Email

GET /v1/emails/:id

Retrieves a previously sent email, including its current status and the full event timeline.

Example

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

StatusMeaning
queuedAccepted and waiting for the worker; also the state while sends are being retried.
scheduledScheduled for a later send.
sentHanded to the upstream provider.
delivery_delayedThe receiving server temporarily deferred delivery.
deliveredAccepted by the recipient’s mail server.
openedThe recipient opened the email.
clickedThe recipient clicked a link.
bouncedThe recipient’s server permanently rejected it.
complainedThe recipient marked it as spam.
suppressedNot sent — the address is on a suppression list.
canceledA scheduled send was canceled.
rejectedRejected before sending.
failedThe send failed after all retries (dead-lettered); error contains the reason.

Errors

StatusCodeCause
404not_foundNo email with this id on your account.
401unauthorizedMissing, malformed, or revoked API key.
Last updated on