Skip to main content
GET
List email

Authorizations

Authorization
string
header
required

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

Query Parameters

limit
integer

The number of items to return

Required range: 1 <= x <= 100
Example:

10

starting_after
string

The ID of the last item in the previous page - used for pagination. You can use the value of the next_starting_after field from the previous response.

Example:

"01956fbd-0eb1-72db-a565-82977a586084"

The search query to filter emails. It can be an email address (the lead email address), or a special string that starts with "thread:" to search for emails in a specific thread. If you want to search for emails in a specific thread, use the "thread:" prefix followed by the thread ID (e.g., "thread:123e4567-e89b-12d3-a456-426614174000").

Example:

"search term"

campaign_id
string<uuid>

The ID of the campaign to filter emails by.

Example:

"123e4567-e89b-12d3-a456-426614174000"

list_id
string<uuid>

The ID of the lead list to filter emails by.

Example:

"123e4567-e89b-12d3-a456-426614174000"

i_status
number

The status of the emails to filter by.

Example:

1

eaccount
string

The email account that was used to send this email. You can filter by multiple email accounts by providing a comma-separated list of email addresses.

Example:

"jon@example.com"

is_unread
boolean

Whether the email is unread.

Example:

true

has_reminder
boolean
Example:

true

mode
enum<string>

The mode to filter emails by.

Available options:
emode_focused,
emode_others,
emode_all
Example:

"emode_focused"

preview_only
boolean

Whether to only return the preview of the emails.

Example:

true

sort_order
enum<string>

The order to sort the emails by (based on the email creation date). Default is "desc".

Available options:
asc,
desc
Example:

"asc"

scheduled_only
boolean

Whether to only return the scheduled emails.

Example:

true

assigned_to
string

The ID of the user to filter emails by.

Example:

"123e4567-e89b-12d3-a456-426614174000"

lead
string

The email of the lead to filter emails by.

Example:

"jondoe@example.com"

company_domain
string

The domain of the company to filter emails by.

Example:

"example.com"

marked_as_done
boolean

Whether the email is marked as done.

Example:

true

email_type
enum<string>

The type of the email to filter by.

Available options:
received,
sent,
manual
Example:

"received"

min_timestamp_created
string

Filter emails created after this timestamp (ISO format)

Example:

"2026-07-25T08:20:31.623Z"

max_timestamp_created
string

Filter emails created before this timestamp (ISO format)

Example:

"2026-07-25T08:20:31.623Z"

latest_of_thread
boolean

Whether to only return the latest email in each thread.

Example:

true

Response

The list of Email

items
Email · object[]
required

The list of Email

next_starting_after
string

The filter for getting the next items after this one, this could either be a UUID, a timestamp, on an email depending on the specific API

Example:

"019f985c-9307-79e3-ad3f-301c6dce9778"