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-03-05T23:09:47.220Z",
      "timestamp_updated": "2026-03-05T23:09:47.220Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019cc043-af54-70e2-ac5a-5f6af8474683",
      "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": "019cc043-af54-70e2-ac5a-5f68fd36b43b",
      "daily_limit": 100,
      "modified_by": "019cc043-af54-70e2-ac5a-5f69334f1f82",
      "tracking_domain_name": "example.com",
      "tracking_domain_status": "active",
      "status": 1,
      "enable_slow_ramp": false,
      "inbox_placement_test_limit": 10,
      "timestamp_last_used": "2026-03-05T23:09:47.220Z",
      "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-03-05T23:09:47.220Z",
      "warmup_pool_id": "019cc043-af54-70e2-ac5a-5f6b82b607b8",
      "dfy_password_changed": false,
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe"
    }
  ],
  "next_starting_after": "019cc043-e2a1-77e6-b52e-bb8678e59603"
}

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<date-time>
Example:

"2026-03-05T23:10:00.353Z"

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

"019cc043-e2a1-77e6-b52e-bb84333cbed5, 019cc043-e2a1-77e6-b52e-bb852203e953"

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:

"019cc043-e2a1-77e6-b52e-bb8678e59603"