Skip to main content
GET
/
emails
List Sent Emails
curl --request GET \
  --url https://app.uselettr.com/api/emails \
  --header 'Authorization: <api-key>'
{
  "message": "Emails retrieved successfully.",
  "data": {
    "results": [
      {
        "event_id": "abc123",
        "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",
        "rcpt_meta": {}
      }
    ],
    "total_count": 1,
    "pagination": {
      "next_cursor": null,
      "per_page": 25
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Format: Bearer {api_key}

Query Parameters

​
per_page
integer
default:25

Number of results per page (1-100)

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor from previous response

​
recipients
string<email>

Filter by recipient email address

​
from
string<date>

Filter emails sent on or after this date (ISO 8601 format)

​
to
string<date>

Filter emails sent on or before this date (ISO 8601 format)

Response

List of sent emails

Response containing a list of sent emails

​
message
string
required

Human-readable response message

Example:

"Emails retrieved successfully."

​
data
object
required