Skip to main content
GET
List emails

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cursor
string

Opaque cursor from a previous response’s meta.nextCursor.

limit
number
default:50
Required range: 1 <= x <= 100
Example:

50

mailbox
string

Filter by mailbox address, comma-separated. Addresses you do not own are ignored.

campaignId
string
Example:

"c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c"

threadId
string

Return only emails in this conversation. Pass a threadId exactly as returned - it is opaque.

Example:

"13a265fd-f0f2-b1d1-d6fc-154e483183e7"

leadId
string
Example:

"9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31"

isUnread
boolean

Filter by read state. Emails that are not part of a conversation have no read state and match neither true nor false.

Example:

true

type
enum<string>
Available options:
sent,
received
Example:

"received"

folder
enum<string>

Return only emails whose conversation is in this folder - the same folders your team sees in the dashboard. inbox: campaign conversations someone replied to. untracked: conversations outside any campaign. important, snoozed, archived: as flagged in the dashboard - important spans the other folders. An email that belongs to no conversation is in no folder and matches none of these.

Available options:
inbox,
untracked,
important,
snoozed,
archived
Example:

"inbox"

Full-text search over subject, preview text and sender address. Supports quoted phrases, OR and -exclude.

Example:

"pricing question"

latestOfThread
boolean

Return one email per conversation: the most recent one that matches the rest of your filters. A cheap conversation-style view without fetching whole threads.

The filters are applied first, then the newest survivor of each conversation is kept – so latestOfThread=true&type=received gives you the last email each contact sent you, even in conversations you have already replied to. An email that belongs to no conversation is a conversation of one and is always kept.

Example:

true

since
string
Example:

"2026-07-01T00:00:00.000Z"

until
string
Example:

"2026-07-14T00:00:00.000Z"

sortOrder
enum<string>
default:desc

Order by received date. Defaults to newest first.

Available options:
asc,
desc

Response

data
object[]
required
meta
object
required