API reference

Retrieve email

GET/api/v2/emails/{id}

Returns one email with its content and every delivery event. Needs a full access key.

Example

curl https://robustemail.com/api/v2/emails/6adc79043cbea \
  -H "Authorization: Bearer $ROBUSTEMAIL_API_KEY"

Response

{
  "object": "email",
  "id": "6adc79043cbea",
  "from": "Acme <hello@acme.com>",
  "to": ["jane@example.com"],
  "cc": null,
  "bcc": null,
  "reply_to": null,
  "subject": "Your receipt",
  "html": "<p>Thanks for your order!</p>",
  "text": null,
  "tags": null,
  "last_event": "delivered",
  "mode": "live",
  "created_at": "2026-10-25T09:30:12+00:00",
  "sent_at": "2026-10-25T09:30:14+00:00",
  "events": [
    { "type": "email.queued", "data": null, "created_at": "2026-10-25T09:30:12+00:00" },
    { "type": "email.sent", "data": null, "created_at": "2026-10-25T09:30:14+00:00" },
    { "type": "email.delivered", "data": null, "created_at": "2026-10-25T09:30:16+00:00" }
  ]
}

Events

EventMeaning
email.queuedAccepted and waiting to be sent.
email.sentHanded to the mail server.
email.deliveredThe receiving server accepted it.
email.delivery_delayedA temporary problem; delivery is being retried.
email.bouncedThe receiving server refused it.
email.complainedThe recipient marked it as spam.
email.failedIt could not be sent.
email.suppressedRecipients on the suppression list were removed. With "partial": true in data, the others were still sent; without it, nobody was left and the email ends here.

last_event holds the latest status. In test mode, events carry "simulated": true in data.

Errors

404 not_found when no email with that ID belongs to your account.