Get Email Detail

curl --request GET \
  --url https://app.lettr.com/api/emails/{requestId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.lettr.com/api/emails/{requestId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.lettr.com/api/emails/{requestId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.lettr.com/api/emails/{requestId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.lettr.com/api/emails/{requestId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.lettr.com/api/emails/{requestId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.lettr.com/api/emails/{requestId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      }
    ]
  }
}

GET

emails

{requestId}

Get Email Detail

curl --request GET \
  --url https://app.lettr.com/api/emails/{requestId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.lettr.com/api/emails/{requestId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.lettr.com/api/emails/{requestId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.lettr.com/api/emails/{requestId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.lettr.com/api/emails/{requestId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.lettr.com/api/emails/{requestId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.lettr.com/api/emails/{requestId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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"
      }
    ]
  }
}

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"

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

Show child attributes

Send Email List Email Events

API Reference

Emails

Scheduled Emails

Domains

Templates

Webhooks

System

Campaigns

Audience Lists

Audience Contacts

Audience Topics

Audience Properties

Audience Segments

Get Email Detail

Authorizations

Path Parameters

Query Parameters

Response