List account

List account

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

import requests

url = "https://api.instantly.ai/api/v2/accounts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.instantly.ai/api/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.get("https://api.instantly.ai/api/v2/accounts")
  .header("Authorization", "Bearer <token>")
  .asString();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "email": "user@example.com",
      "timestamp_created": "2026-07-25T08:20:19.377Z",
      "timestamp_updated": "2026-07-25T08:20:19.377Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019f985c-6331-71f0-9e3d-05da43dbd6ac",
      "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": "019f985c-6331-71f0-9e3d-05d8f576ab56",
      "daily_limit": 100,
      "daily_limit_max": 100,
      "warmup_limit_max": 100,
      "modified_by": "019f985c-6331-71f0-9e3d-05d93c75a6e5",
      "tracking_domain_name": "example.com",
      "tracking_domain_status": "active",
      "status": 1,
      "enable_slow_ramp": false,
      "inbox_placement_test_limit": 10,
      "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-07-25T08:20:19.377Z",
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe",
      "reply_to": "reply@example.com",
      "autofix_failed": false,
      "tags": [
        {
          "id": "019f985c-9224-7a09-a7b4-db7d2c16870a",
          "label": "Important tag",
          "description": null
        }
      ]
    }
  ],
  "next_starting_after": "019f985c-9224-7a09-a7b4-db7ee2bc4a46"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

GET

api

accounts

List account

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

import requests

url = "https://api.instantly.ai/api/v2/accounts"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.instantly.ai/api/v2/accounts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.get("https://api.instantly.ai/api/v2/accounts")
  .header("Authorization", "Bearer <token>")
  .asString();

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.instantly.ai/api/v2/accounts",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.instantly.ai/api/v2/accounts"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "email": "user@example.com",
      "timestamp_created": "2026-07-25T08:20:19.377Z",
      "timestamp_updated": "2026-07-25T08:20:19.377Z",
      "first_name": "John",
      "last_name": "Doe",
      "organization": "019f985c-6331-71f0-9e3d-05da43dbd6ac",
      "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": "019f985c-6331-71f0-9e3d-05d8f576ab56",
      "daily_limit": 100,
      "daily_limit_max": 100,
      "warmup_limit_max": 100,
      "modified_by": "019f985c-6331-71f0-9e3d-05d93c75a6e5",
      "tracking_domain_name": "example.com",
      "tracking_domain_status": "active",
      "status": 1,
      "enable_slow_ramp": false,
      "inbox_placement_test_limit": 10,
      "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-07-25T08:20:19.377Z",
      "stat_warmup_score": 85,
      "sending_gap": 10,
      "signature": "Best regards, John Doe",
      "reply_to": "reply@example.com",
      "autofix_failed": false,
      "tags": [
        {
          "id": "019f985c-9224-7a09-a7b4-db7d2c16870a",
          "label": "Important tag",
          "description": null
        }
      ]
    }
  ],
  "next_starting_after": "019f985c-9224-7a09-a7b4-db7ee2bc4a46"
}

{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing Authorization header"
}

{
  "statusCode": 402,
  "error": "Payment Required",
  "message": "Workspace does not have an active paid plan"
}

{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found"
}

{
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Rate limit exceeded"
}

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"

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:

"019f985c-9224-7a09-a7b4-db79754c00ee, 019f985c-9224-7a09-a7b4-db7aa71678ef"

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:

"019f985c-9224-7a09-a7b4-db7b8e018d79, 019f985c-9224-7a09-a7b4-db7ccbc62483"

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"

sort_by

enum<string>

Column to sort results by.

Available options:

timestamp_created,

email,

stat_warmup_score,

status

Example:

"stat_warmup_score"

sort_order

enum<string>

Sort direction. Defaults to desc when sort_by is provided.

Available options:

asc,

desc

Example:

"desc"

skip

integer

Number of items to skip for offset-based pagination. Used with sort_by when cursor pagination is not available.

Required range: x >= 0

Example:

0

Response

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:

"019f985c-9224-7a09-a7b4-db7ee2bc4a46"

Get campaigns associated with an email Create account

⌘I

Overview

Getting Started

Guides

Resources

Schemas

Authorizations

Query Parameters

Response