Retrieve email

GET/api/v1/emails/:id

Fetch a send by the id returned from send/batch. Includes the per-recipient delivery timeline— every provider event we've ingested for the message.

curl https://www.noticeapi.com/api/v1/emails/EMAIL_ID \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "id": "5f0c1a...",
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Your receipt",
  "status": "accepted",
  "deliveryStatus": "delivered",
  "provider": "noticeapi_email_api",
  "messageId": "0f83...",
  "createdAt": "2026-07-02T18:04:11.000Z",
  "events": [
    { "type": "delivered", "recipient": "[email protected]",
      "detail": "OK", "at": "2026-07-02T18:04:14.000Z" },
    { "type": "opened", "recipient": null, "at": "2026-07-02T18:09:02.000Z" }
  ]
}
FieldTypeDescription
statusstringaccepted | failed — whether the API accepted the send.
deliveryStatusstring | nullLatest terminal outcome: queued, delivered, bounced, spam, quarantined, suppressed, failed.
events[].typestringdelivered, bounced, spam, quarantined, suppressed, failed, opened, clicked, unsubscribed.