Skip to main content
GET
/
emails
/
{requestId}
Get Email Details
curl --request GET \
  --url https://app.uselettr.com/api/emails/{requestId} \
  --header 'Authorization: <api-key>'
{
  "message": "Email retrieved successfully.",
  "data": {
    "results": [
      {
        "event_id": "event-123",
        "type": "injection",
        "timestamp": "2024-01-15T10:30:00.000Z",
        "request_id": "trans-456",
        "message_id": "msg-789",
        "subject": "Welcome to Lettr",
        "friendly_from": "[email protected]",
        "sending_domain": "example.com",
        "rcpt_to": "[email protected]",
        "raw_rcpt_to": "[email protected]",
        "recipient_domain": "example.com",
        "mailbox_provider": "gmail",
        "mailbox_provider_region": "us",
        "sending_ip": "192.168.1.1",
        "click_tracking": true,
        "open_tracking": true,
        "transactional": true,
        "msg_size": 1024,
        "injection_time": "2024-01-15T10:30:00.000Z",
        "reason": null,
        "raw_reason": null,
        "error_code": null,
        "rcpt_meta": {}
      },
      {
        "event_id": "event-124",
        "type": "delivery",
        "timestamp": "2024-01-15T10:30:05.000Z",
        "request_id": "trans-456",
        "message_id": "msg-789",
        "subject": "Welcome to Lettr",
        "friendly_from": "[email protected]",
        "sending_domain": "example.com",
        "rcpt_to": "[email protected]",
        "raw_rcpt_to": "[email protected]",
        "recipient_domain": "example.com",
        "mailbox_provider": "gmail",
        "mailbox_provider_region": "us",
        "sending_ip": "192.168.1.1",
        "click_tracking": true,
        "open_tracking": true,
        "transactional": true,
        "msg_size": 1024,
        "injection_time": "2024-01-15T10:30:00.000Z",
        "reason": null,
        "raw_reason": null,
        "error_code": null,
        "rcpt_meta": {}
      }
    ],
    "total_count": 2
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: Bearer {api_key}

Path Parameters

​
requestId
string
required

The request_id (transmission ID) returned when sending the email

Response

Email events retrieved

Response containing email details and events

​
message
string
required

Human-readable response message

Example:

"Email retrieved successfully."

​
data
object
required