Retrieve an email
Get one email with its recipients and full event timeline.
/v1/emails/{id}API keyReturns everything Flaresend knows about one email: its status, each recipient's delivery result, and every event in its timeline, oldest first. It doesn't include the body; use Retrieve email content for that.
Path parameters
The email ID, for example email_01K6B2Y4ZP9R3M7T8V5N2QXW4C.
Response
The email ID.
The project it belongs to.
test when it was sent with a test key.
How it was sent: http (single send over the API, or a resend from the dashboard), batch, rpc or broadcast.
The sender's bare address, lowercased.
The sender's display name, if one was given.
The reply-to address.
Bare addresses, lowercased and deduplicated. cc and bcc are the same.
The final subject, after any template was rendered.
The first 200 characters of the text body, or of the HTML with tags removed.
The template name, when one was used.
The version of a stored template that was rendered. null for built-in templates.
The email's overall status. See Email statuses for what each value means and how it's worked out from the recipients.
The message ID Cloudflare returned when it accepted the email. Set once the email is sent.
The most recent send error, for example { "code": "E_RATE_LIMIT_EXCEEDED", "message": "…" }. Cleared when a retry succeeds. Every attempt is also in the timeline as an email.retrying event.
How many times the send queue tried to hand it to Cloudflare.
The stored size of the email, attachments included.
How many attachments it has.
Whether open tracking was applied. trackClicks is the same for clicks.
When it was first opened, if open tracking was on. firstClickedAt is the same for clicks.
When Flaresend accepted it. The other timestamps are queuedAt, sentAt, deliveredAt, failedAt (set when it reaches a failure status) and scheduledAt. Each is null until it happens.
One entry per address, with its own delivery result.
Show recipient propertiesHide recipient properties
The address.
Which list it was in.
queued, sent, delivered, deferred, bounced, complained, rejected, failed, test or canceled.
The receiving mail provider, when Cloudflare reports it.
The SMTP status code from the receiving server, for example 250 or 550.
The receiving server's response text.
How long delivery took, in milliseconds.
For bounces. Hard bounces add the address to the suppression list.
When the last delivery event for this address arrived.
The timeline, oldest first.
Show event propertiesHide event properties
The event ID, evt_….
email.queued, email.scheduled, email.sent, email.retrying, email.delivered, email.deferred, email.bounced, email.complained, email.rejected, email.failed, email.test, email.canceled, email.opened or email.clicked.
The address the event is about. null for events about the whole email.
Details that depend on the type: Cloudflare's delivery result (and bounce, rejection and so on) for delivery events, { messageId } for email.sent, { code, message, attempt, delaySeconds } for email.retrying, { url, userAgent } for email.clicked.
When it happened.
Errors
| Status | Code | When |
|---|---|---|
| 404 | email_not_found | No email with that ID in this project. |