Skip to main content
GET
/
api
/
v2
/
accounts
List account
curl --request GET \
  --url https://api.instantly.ai/api/v2/accounts \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "email": "user@example.com",
      "timestamp_created": "2026-04-26T02:24:44.979Z",
      "timestamp_updated": "2026-04-26T02:24:44.979Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019dc79a-81b3-792f-b216-2937258babd2",
      "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": "019dc79a-81b3-792f-b216-29354440cf1f",
      "daily_limit": 100,
      "modified_by": "019dc79a-81b3-792f-b216-2936155eaa74",
      "tracking_domain_name": "example.com",
      "tracking_domain_status": "active",
      "status": 1,
      "enable_slow_ramp": false,
      "inbox_placement_test_limit": 10,
      "timestamp_last_used": "2026-04-26T02:24:44.979Z",
      "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-04-26T02:24:44.979Z",
      "warmup_pool_id": "019dc79a-81b3-792f-b216-293812760e93",
      "dfy_password_changed": false,
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe",
      "autofix_failed": false
    }
  ],
  "next_starting_after": "019dc79a-c2fb-7ec5-b8a1-a6caab8d8e3a"
}

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&jon@doe.com"

​
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:

"019dc79a-c2fb-7ec5-b8a1-a6c60d4a8591, 019dc79a-c2fb-7ec5-b8a1-a6c7d1bbb4ff"

​
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:

"019dc79a-c2fb-7ec5-b8a1-a6c8f0ced1dc, 019dc79a-c2fb-7ec5-b8a1-a6c9532a48c3"

Response

The list of Account

​
items
Account · object[]
required

The list of Account

​
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:

"019dc79a-c2fb-7ec5-b8a1-a6caab8d8e3a"