Emails

Get Email Detail

Retrieve all events for a specific sent email by its request ID. Returns delivery, bounce, open, click, and other events in reverse chronological order. If no from date is provided, defaults to the last 10 days.

get/emails/{requestId}

Request

  • Base URL: https://app.lettr.com/api
  • URL: https://app.lettr.com/api/emails/{requestId}
  • Auth: HTTP bearer

Path parameters

requestIdstring required
Example:7610639000055488914

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

Query parameters

fromstring date
Example:2024-01-01

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

tostring date
Example:2024-01-31

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

Response

Email detail retrieved successfully

messagestring required

Example response

{
  "message": "Email retrieved successfully.",
  "data": {
    "transmission_id": "12345678901234567890",
    "state": "delivered",
    "from": "sender@example.com",
    "subject": "Welcome to Lettr",
    "recipients": [
      "recipient@example.com"
    ],
    "num_recipients": 1,
    "events": [
      {
        "event_id": "7609871845907017144",
        "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",
        "message_id": "699715cd9e6961853a97",
        "subject": "Welcome to Lettr",
        "friendly_from": "sender@example.com",
        "sending_domain": "example.com",
        "sending_ip": "168.203.51.91",
        "msg_size": 30823,
        "injection_time": "2024-01-15T10:30:00.000Z",
        "campaign_id": "welcome-series",
        "template_id": "template_7610639000055488914",
        "template_version": "0",
        "ip_pool": "default",
        "msg_from": "msprvs1=abc123=bounces@sparkpostmail1.com",
        "delv_method": "esmtp",
        "recv_method": "rest",
        "routing_domain": "gmail.com"
      }
    ]
  }
}

Changes

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