INinstantly
Email

List email

Changed on

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

Request

  • Base URL
    https://api.instantly.ai
  • URL
    https://api.instantly.ai/api/v2/emails
  • Auth
    HTTP bearer

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. When false, a body too large to include in the list is returned as an excerpt and marked by body_fallback_reason.

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-11-02T22:42:23.221Z

Filter emails created after this timestamp (ISO format)

max_timestamp_createdstring
Example:2026-11-02T22:42:23.221Z

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": "01a19e6d-50d9-7007-981c-eb1ee78f4453",
      "timestamp_created": "2026-11-02T22:42:06.681Z",
      "timestamp_email": "2026-11-02T22:42:06.681Z",
      "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": "This is a test email.<br/><br/>Second line."
      },
      "organization_id": "01a19e6d-50d9-7007-981c-eb1fe54b170a",
      "campaign_id": "01a19e6d-50d9-7007-981c-eb2095281918",
      "subsequence_id": "01a19e6d-50d9-7007-981c-eb21e48f2f91",
      "list_id": "01a19e6d-50d9-7007-981c-eb2285414996",
      "lead": "jondoe@example.com",
      "lead_id": "01a19e6d-50d9-7007-981c-eb2318d1d203",
      "eaccount": "eaccount-123",
      "ue_type": 3,
      "step": "step-123",
      "is_unread": 1,
      "reminder_ts": "2026-11-02T22:42:06.681Z",
      "ai_interest_value": 0.75,
      "ai_assisted": 1,
      "is_focused": 1,
      "thread_id": "01a19e6d-50d9-7007-981c-eb24ac1271ce",
      "content_preview": "This is a preview of the email content.",
      "body_fallback_reason": "too_large",
      "attachment_json": {
        "files": [
          {
            "filename": "attachment",
            "size": 1927,
            "type": "text/css",
            "url": "https://cdn.instantly.ai/example-attachment/",
            "error": null
          }
        ]
      },
      "ai_agent_id": "01a19e6d-50d9-7007-981c-eb2543954566"
    }
  ],
  "next_starting_after": "01a19e6d-9175-7777-b916-00e9c6e0ee48"
}

Changes