Skip to main content
GET
/
v1
/
emails
/
{id}
Get Email
curl --request GET \
  --url https://api.example.com/v1/emails/{id}

​
Get Email

Retrieve details of a specific email by its ID.
​
id
string
required
The ID of the email to retrieve.

​
Request

curl https://api.lettr.dev/v1/emails/email_123abc \
  -H "Authorization: Bearer le_xxxxxxxxxxxx"

​
Response

{
  "id": "email_123abc",
  "object": "email",
  "from": "you@example.com",
  "to": ["recipient@example.com"],
  "cc": [],
  "bcc": [],
  "subject": "Hello World",
  "status": "delivered",
  "html": "<p>Welcome to Lettr!</p>",
  "text": "Welcome to Lettr!",
  "tags": ["welcome"],
  "metadata": {
    "userId": "user_123"
  },
  "opens": 3,
  "clicks": 1,
  "firstOpenedAt": "2024-01-15T11:00:00Z",
  "lastOpenedAt": "2024-01-15T14:30:00Z",
  "deliveredAt": "2024-01-15T10:30:05Z",
  "createdAt": "2024-01-15T10:30:00Z"
}

​
Email Status

StatusDescription
queuedEmail is queued for sending
sentEmail has been sent
deliveredEmail was delivered
bouncedEmail bounced
failedDelivery failed
scheduledEmail is scheduled for future delivery
cancelledScheduled email was cancelled
suppressedRecipient was suppressed

​
Errors

CodeDescription
not_foundEmail with specified ID not found