Emails

Get email details

Retrieve the current status and delivery events for a specific email by its ID.

get/v1/emails/{id}

Request

  • Base URL: https://smtpfa.st/api
  • URL: https://smtpfa.st/api/v1/emails/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The email ID (e.g. email_abc123)

Response

Email details

idstring required
fromstring required

As sent, so it can include a display name: Name hello@yourapp.com

tostring[] required
ccstring[] required
bccstring[] required
subjectstring required
htmlstring nullable required

The stored body. For an API send the {{unsubscribe_url}} placeholder is filled in when the email goes out, so it appears here unreplaced; broadcast and form emails are stored with the real link. Null when there was no HTML body or the retention window removed it.

textstring nullable required

The stored plain-text body, null when there was none or the retention window removed it.

created_atstring date-time required
last_eventstring required

The type of the newest event, or the status when the email has no events yet. Resend-compatible.

body_cleared_atstring date-time nullable required

When the retention window removed html and text. Null while the body is kept, so null html and text with a timestamp here means the content is no longer stored.

sourcestring required

api, smtp, dashboard, broadcast or broadcast_test

category'transactional' | 'marketing' required

Decides which suppressions apply and whether the List-Unsubscribe header went out. marketing unless the email was labelled transactional; broadcasts, signup form emails and emails sent before categories existed are marketing.

status'queued' | 'scheduled' | 'sending' | 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'failed' | 'canceled' required
reply_tostring nullable required

The Reply-To address the email was sent with, or null.

message_idstring nullable required

The RFC 5322 Message-ID on your sending domain, the one a recipient's server and bounce reports quote. Null until the email is sent.

ses_message_idstring nullable required

The Amazon SES message id. Kept for older integrations; correlate with message_id.

sent_atstring date-time nullable required
delivered_atstring date-time nullable required
opened_atstring date-time nullable required
clicked_atstring date-time nullable required
bounced_atstring date-time nullable required
unsubscribed_atstring date-time nullable required

When the recipient unsubscribed through this email. status keeps its delivery value.

error_messagestring nullable required

Example response

{
  "id": "email_abc123",
  "from": "hello@yourapp.com",
  "to": [
    "user@example.com"
  ],
  "cc": [],
  "bcc": [],
  "subject": "Welcome!",
  "created_at": "2026-04-05T12:00:00Z",
  "last_event": "delivered",
  "source": "api",
  "category": "transactional",
  "status": "queued",
  "tags": [
    {
      "name": "campaign",
      "value": "welcome"
    }
  ],
  "events": [
    {
      "type": "delivered"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.