---
title: "List account"
method: GET
path: "/api/v2/accounts"
tags: ["Account"]
---

# List account

`GET /api/v2/accounts`

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

## Query parameters

- `limit` integer
- `starting_after` string
- `search` string
- `status` 1 | 2 | 3 | -1 | -2 | -3
- `provider_code` 1 | 2 | 3 | 4 | 8
- `tag_ids` string
- `tag_ids_all` string
- `include_tags` boolean
- `filter` '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'
- `sort_by` 'timestamp_created' | 'email' | 'stat_warmup_score' | 'status'
- `sort_order` 'asc' | 'desc'
- `skip` integer

## Response `200`

The list of Account

- object
  - `items` object[], required — The list of Account
    - `email` string, email, required — Email address of the account
    - `timestamp_created` string, date-time, required — Timestamp when the account was created
    - `timestamp_updated` string, date-time, required — Timestamp when the account was last updated
    - `first_name` string, required — First name associated with the account
    - `last_name` string, required — Last name associated with the account
    - `warmup` object — Warmup configuration for the account
      - `limit` number — Email sending limit for the account
      - `advanced` object — Advanced settings for the account
        - `warm_ctd` boolean — Whether the account is in warm CTD mode
        - `open_rate` number — Email open rate for the account
        - `important_rate` number — Important email rate for the account
        - `read_emulation` boolean — Whether read emulation is enabled
        - `spam_save_rate` number — Spam save rate for the account
        - `weekday_only` boolean — Whether to send emails only on weekdays
      - `warmup_custom_ftag` string — Custom tag for the account
      - `increment` 'disabled' | '0' | '1' | '2' | '3' | '4' — Daily increment added to the sending limit, starting from 0, until the full daily limit is reached (slow ramp). Gradually increases sending volume to improve deliverability. Set to `disabled` to send at the full daily limit from day one.
      - `reply_rate` number — Reply rate for the account
    - `added_by` string, uuid, nullable — User ID who added the account
    - `daily_limit` number, nullable — Daily email sending limit
    - `daily_limit_max` number, nullable — Maximum daily email sending limit for AirMail accounts
    - `warmup_limit_max` number, nullable — Maximum daily warmup sending limit for AirMail accounts
    - `modified_by` string, uuid, nullable — User ID who last modified the account
    - `tracking_domain_name` string, nullable — Tracking domain
    - `tracking_domain_status` string, nullable — Tracking domain status
    - `status` 1 | 2 | 3 | -1 | -2 | -3 — Current status of the account
    - `enable_slow_ramp` boolean, nullable — Whether to enable slow ramp up for sending limits
    - `inbox_placement_test_limit` number, nullable — The limit for inbox placement tests
    - `organization` string, uuid, required — Organization ID that owns this account
    - `warmup_status` 0 | 1 | -1 | -2 | -3, required — Current warmup status of the account
    - `status_message` object — Status message for the account
      - `code` string
      - `command` string
      - `response` string
      - `e_message` string
      - `responseCode` number
    - `timestamp_warmup_start` string, date-time, nullable — Timestamp when warmup was started
    - `provider_code` 1 | 2 | 3 | 4 | 8, required — Provider code for the account. Please make sure to specify the right provider code, otherwise your account will not work.
    - `setup_pending` boolean, required — Whether account setup is pending
    - `is_managed_account` boolean, required — Whether this is a managed account
    - `stat_warmup_score` number, nullable — Warmup score for the account
    - `sending_gap` number — The gap between emails sent from this account in minutes (minimum wait time when used with multiple campaigns)
    - `signature` string, nullable — Email signature for the account
    - `reply_to` string, email, nullable — Custom reply-to email address for the account
    - `autofix_failed` boolean, nullable — Whether automatic reconnection attempts have failed. null = in progress, true = failed, false = succeeded.
    - `tags` object[], nullable — Tags associated with the account, set to `include_tags` to populate
      - `id` string — Unique identifier for the custom tag
      - `label` string — Display label for the custom tag
      - `description` string, nullable — Detailed description of the custom tag purpose
  - `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

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)