Skip to main content
GET
/
emails
/
{requestId}
Get Email Detail
curl --request GET \
  --url https://app.lettr.com/api/emails/{requestId} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Email retrieved successfully.",
  "data": {
    "transmission_id": "7610639000055488914",
    "state": "delivered",
    "scheduled_at": null,
    "from": "sender@example.com",
    "from_name": null,
    "subject": "Welcome to Lettr",
    "recipients": [
      "recipient@example.com"
    ],
    "num_recipients": 1,
    "events": [
      {
        "event_id": "event-open-1",
        "type": "open",
        "timestamp": "2024-01-15T10:32:00.000Z",
        "request_id": "7610639000055488914",
        "rcpt_to": "recipient@example.com",
        "raw_rcpt_to": "recipient@example.com",
        "recipient_domain": "example.com",
        "mailbox_provider": "Gmail",
        "mailbox_provider_region": "Global",
        "subject": "Welcome to Lettr",
        "friendly_from": "sender@example.com"
      },
      {
        "event_id": "event-delivery-1",
        "type": "delivery",
        "timestamp": "2024-01-15T10:31:00.000Z",
        "request_id": "7610639000055488914",
        "rcpt_to": "recipient@example.com",
        "raw_rcpt_to": "recipient@example.com",
        "recipient_domain": "example.com",
        "mailbox_provider": "Gmail",
        "mailbox_provider_region": "Global",
        "subject": "Welcome to Lettr",
        "friendly_from": "sender@example.com",
        "queue_time": 500
      },
      {
        "event_id": "event-injection-1",
        "type": "injection",
        "timestamp": "2024-01-15T10:30:00.000Z",
        "request_id": "7610639000055488914",
        "rcpt_to": "recipient@example.com",
        "raw_rcpt_to": "recipient@example.com",
        "recipient_domain": "example.com",
        "mailbox_provider": "Gmail",
        "mailbox_provider_region": "Global",
        "subject": "Welcome to Lettr",
        "friendly_from": "sender@example.com"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.lettr.com/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve all events for a specific sent email by its request ID.

Authorizations

​
Authorization
string
header
required

API key for authentication

Path Parameters

​
requestId
string
required

The request ID (transmission ID) of the sent email.

Example:

"7610639000055488914"

Query Parameters

​
from
string<date>

Start date for the event search range. Defaults to 10 days ago if not provided.

Example:

"2024-01-01"

​
to
string<date>

End date for the event search range. Defaults to now if not provided.

Example:

"2024-01-31"

Response

Email detail retrieved successfully

Email detail response. Uses the same data shape as the scheduled transmission detail — see ShowScheduledTransmissionResponse for field descriptions.

​
message
string
required
Example:

"Email retrieved successfully."

​
data
object
required