Skip to main content
GET
List emails

Authorizations

Authorization
string
header
required

An API key from the dashboard. sk_live_… sends; sk_test_… validates and returns ids without sending.

Query Parameters

status
enum<string>
Available options:
queued,
sent,
delivered,
bounced,
complained,
failed,
expired,
rejected
tag
string

Exact match on one tag.

Maximum string length: 64
to
string

Substring of the recipient, case-insensitive.

Maximum string length: 254
since
string<date-time>

ISO 8601 date-time; emails created at or after it.

until
string<date-time>

ISO 8601 date-time; emails created before it.

limit
integer
default:50
Required range: 1 <= x <= 100
cursor
string

The nextCursor of the previous page.

Response

A page of emails

data
object[]
required
nextCursor
string | null
required

Pass as cursor for the next page; null on the last page.