List account

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

GET /api/v2/accounts

List account

cURL

curl --request GET \
  --url https://api.instantly.ai/api/v2/accounts \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "email": "[e-mail]",
      "timestamp_created": "2026-05-18T16:00:49.652Z",
      "timestamp_updated": "2026-05-18T16:00:49.652Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019e3bd1-8df4-7938-a6b5-fda3e9fcee2c",
      "warmup_status": 1,
      "provider_code": 2,
      "setup_pending": false,
      "is_managed_account": false,
      "warmup": {
        "limit": 100,
        "advanced": {
          "warm_ctd": false,
          "open_rate": 0.95,
          "important_rate": 0.8,
          "read_emulation": true,
          "spam_save_rate": 0.02,
          "weekday_only": true
        },
        "warmup_custom_ftag": "warmup",
        "increment": "disabled",
        "reply_rate": 0.1
      },
      "added_by": "019e3bd1-8df4-7938-a6b5-fda13b232c2c",
      "daily_limit": 100,
      "modified_by": "019e3bd1-8df4-7938-a6b5-fda23337f795",
      "tracking_domain_name": "example.com",
      "tracking_domain_status": "active",
      "status": 1,
      "enable_slow_ramp": false,
      "inbox_placement_test_limit": 10,
      "timestamp_last_used": "2026-05-18T16:00:49.652Z",
      "status_message": {
        "code": "EENVELOPE",
        "command": "DATA",
        "response": "550-5.4.5 Daily user sending limit exceeded. For more information on Gmai",
        "e_message": "error: data command failed: 550-5.4.5 daily user sending limit exceeded",
        "responseCode": 550
      },
      "timestamp_warmup_start": "2026-05-18T16:00:49.652Z",
      "warmup_pool_id": "019e3bd1-8df4-7938-a6b5-fda45d476f73",
      "dfy_password_changed": false,
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe",
      "autofix_failed": false,
      "tags": [
        {
          "id": "019e3bd1-b4ae-7bfb-a47f-33bd3bff3e5c",
          "label": "Important tag",
          "description": null
        }
      ]
    }
  ],
  "next_starting_after": "019e3bd1-b4ae-7bfb-a47f-33beb27957c9"
}

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

Pagination cursor from next_starting_after, in timestamp_created&email format. Legacy ISO date-time cursor is still supported.

Example:

"2026-01-01T00:00:00.000Z&[e-mail]"

search · string

Example:

"gmail.com"

status · enum<number>

Available options: 1, 2, 3, -1, -2, -3

Example:

1

provider_code · enum<number>

Available options: 1, 2, 3, 4, 8

Example:

2

tag_ids · string

Filter accounts by tag ids. Returns accounts that have any of the specified tags assigned. You can specify multiple tag ids by separating them with a comma.

Example:

"019e3bd1-b4ae-7bfb-a47f-33b9699cc37c, 019e3bd1-b4ae-7bfb-a47f-33ba604979ef"

tag_ids_all · string

Filter accounts by tag ids with AND logic. Returns only accounts that have all of the specified tags assigned. You can specify multiple tag ids by separating them with a comma.

Example:

"019e3bd1-b4ae-7bfb-a47f-33bb53d1b5ef, 019e3bd1-b4ae-7bfb-a47f-33bcaa408608"

include_tags · boolean

Include tags in the response. If true, the response will include the tags assigned to each account.

Example:

true

filter · enum<string>

The filter to apply to the accounts.

Available options: ACC_FILTER_PAUSED, ACC_FILTER_ERROR, ACC_FILTER_NO_CTD, ACC_FILTER_PW_ACCOUNTS, ACC_FILTER_DFY, ACC_FILTER_DFY_SETUP_PENDING, ACC_FILTER_W_ACTIVE, ACC_FILTER_W_PAUSED, ACC_FILTER_W_ERROR

Example:

"ACC_FILTER_PAUSED"

Response

200

application/json

The list of Account

items · Account · object[] · required

The list of Account

Show child attributes

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:

"019e3bd1-b4ae-7bfb-a47f-33beb27957c9"