Sign in

v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB
Email

List email

Rate Limit: This endpoint has a rate limit of 20 requests per minute, unlike other API endpoints.

Requires one of the following scopes: emails:read, emails:all, all:read, all:all

get/api/v2/emails

Query parameters

limitinteger
Example:10

The number of items to return

starting_afterstring
Example:01956fbd-0eb1-72db-a565-82977a586084

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.

searchstring
Example:search term

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").

campaign_idstring uuid
Example:123e4567-e89b-12d3-a456-426614174000

The ID of the campaign to filter emails by.

list_idstring uuid
Example:123e4567-e89b-12d3-a456-426614174000

The ID of the lead list to filter emails by.

i_statusnumber
Example:1

The status of the emails to filter by.

eaccountstring
Example:jon@example.com

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.

is_unreadboolean
Example:true

Whether the email is unread.

has_reminderboolean
Example:true
mode'emode_focused' | 'emode_others' | 'emode_all'
Example:emode_focused

The mode to filter emails by.

preview_onlyboolean
Example:true

Whether to only return the preview of the emails.

sort_order'asc' | 'desc'
Example:asc

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

scheduled_onlyboolean
Example:true

Whether to only return the scheduled emails.

assigned_tostring
Example:123e4567-e89b-12d3-a456-426614174000

The ID of the user to filter emails by.

leadstring
Example:jondoe@example.com

The email of the lead to filter emails by.

company_domainstring
Example:example.com

The domain of the company to filter emails by.

marked_as_doneboolean
Example:true

Whether the email is marked as done.

email_type'received' | 'sent' | 'manual'
Example:received

The type of the email to filter by.

min_timestamp_createdstring
Example:2026-07-24T15:45:35.365Z

Filter emails created after this timestamp (ISO format)

max_timestamp_createdstring
Example:2026-07-24T15:45:35.365Z

Filter emails created before this timestamp (ISO format)

latest_of_threadboolean
Example:true

Whether to only return the latest email in each thread.

Response

The list of Email

next_starting_afterstring

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 response

{
  "items": [
    {
      "id": "019f94cd-83dc-7a33-bb74-3dab6085f19c",
      "timestamp_created": "2026-07-24T15:45:24.444Z",
      "timestamp_email": "2026-07-24T15:45:24.444Z",
      "message_id": "<example123@mail.gmail.com>",
      "subject": "Re: Your inquiry",
      "from_address_email": "sender@example.com",
      "to_address_email_list": "recipient@example.com",
      "cc_address_email_list": "cc@example.com",
      "bcc_address_email_list": "bcc@example.com",
      "reply_to": "replyto@example.com",
      "body": {
        "text": "This is a test email",
        "html": "<p>This is a test email</p>"
      },
      "organization_id": "019f94cd-83dc-7a33-bb74-3dac64c56a27",
      "campaign_id": "019f94cd-83dc-7a33-bb74-3daded4fd3d0",
      "subsequence_id": "019f94cd-83dc-7a33-bb74-3daeb18d1836",
      "list_id": "019f94cd-83dc-7a33-bb74-3daf4f6d254a",
      "lead": "jondoe@example.com",
      "lead_id": "019f94cd-83dc-7a33-bb74-3db0055cb74b",
      "eaccount": "eaccount-123",
      "ue_type": 3,
      "step": "step-123",
      "is_unread": 1,
      "reminder_ts": "2026-07-24T15:45:24.444Z",
      "ai_interest_value": 0.75,
      "ai_assisted": 1,
      "is_focused": 1,
      "thread_id": "019f94cd-83dc-7a33-bb74-3db1037a0918",
      "content_preview": "This is a preview of the email content.",
      "attachment_json": {
        "files": [
          {
            "filename": "attachment",
            "size": 1927,
            "type": "text/css",
            "url": "https://cdn.instantly.ai/example-attachment/",
            "error": null
          }
        ]
      },
      "ai_agent_id": "019f94cd-83dc-7a33-bb74-3db29c8a7faf"
    }
  ],
  "next_starting_after": "019f94cd-ae85-71b8-9665-5db2c1ab9ce4"
}