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": {
    "events": {
      "data": [
        {
          "event_id": "event-open-1",
          "type": "open",
          "timestamp": "2024-01-15T10:32:00.000Z",
          "request_id": "7610639000055488914",
          "rcpt_to": "recipient@example.com",
          "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",
          "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",
          "subject": "Welcome to Lettr",
          "friendly_from": "sender@example.com"
        }
      ],
      "total_count": 3,
      "from": "2024-01-05T00:00:00+00:00",
      "to": "2024-01-15T10:35:00+00:00"
    }
  }
}
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

​
message
string
required
Example:

"Email retrieved successfully."

​
data
object
required