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-17T16:56:43.383Z",
      "timestamp_updated": "2026-04-17T16:56:43.383Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019d9c5f-9677-78ed-b2c4-298f5dc7fad3",
      "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": "019d9c5f-9677-78ed-b2c4-298d410e72fb",
      "daily_limit": 100,
      "modified_by": "019d9c5f-9677-78ed-b2c4-298e39cbc032",
      "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-17T16:56:43.383Z",
      "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-17T16:56:43.383Z",
      "warmup_pool_id": "019d9c5f-9677-78ed-b2c4-29901918e4b7",
      "dfy_password_changed": false,
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe",
      "autofix_failed": false
    }
  ],
  "next_starting_after": "019d9c5f-cb97-7ba4-ae4c-3e705c2511b8"
}

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:

"019d9c5f-cb97-7ba4-ae4c-3e6e93153f51, 019d9c5f-cb97-7ba4-ae4c-3e6f77046bca"

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:

"019d9c5f-cb97-7ba4-ae4c-3e705c2511b8"