---
title: "Account status and next step"
method: GET
path: "/v2/account/status"
tags: ["Account"]
---

# Account status and next step

`GET /v2/account/status`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/v2/account/status`
- Auth: HTTP bearer

What the workspace has and what to do next.

Returns subscription and mailbox quota, domains and mailboxes by state,
warm-up progress with a ready estimate, open agent orders, whether
campaigns are enabled, and `next_action` + `next_step` + absolute `links`.
`next_action` is one of: pay_order, wait_provisioning,
buy_or_connect_domains, create_mailboxes, start_warmup, wait_warmup,
create_campaign, ready.

## Query parameters

- `workspaceId` integer, nullable: Workspace to report on. Optional for keys bound to one workspace; an unbound key without it gets the list of its workspaces.

## Response `200`

Successful Response

- union
  - AccountStatusOut
    - `workspace` AccountWorkspaceOut, required
      - `id` integer, required
      - `name` string, required
    - `subscription` AccountSubscriptionOut, required
      - `active` boolean, required: Stripe subscription exists and payment is not failed/canceled.
      - `payment_status` 'none' | 'ok' | 'failed' | 'canceled' | 'unknown', required
      - `mailboxes_quota` integer, required
      - `mailboxes_used` integer, required
      - `mailboxes_available` integer, required
    - `domains` AccountDomainsOut, required
      - `total` integer, required
      - `by_state` object, required: active, pending, transferring, needs_attention, failed, other.
    - `mailboxes` AccountMailboxesOut, required
      - `total` integer, required
      - `by_state` object, required: active, pending, error, inactive, other.
    - `warmup` AccountWarmupOut, required
      - `not_started` integer, required
      - `warming` integer, required: Warming now, including the ones already warmed up.
      - `ready` integer, required: Warming for at least ready_after_days.
      - `paused` integer, required
      - `error` integer, required
      - `ready_after_days` integer, required
      - `ready_at` string, nullable: Estimate (UTC ISO 8601) when every warming mailbox is warmed up.
    - `open_orders` AccountOpenOrderOut[], required
      - `order_id` string, required
      - `status` string, required
    - `campaigns_enabled` boolean, required
    - `active_campaigns` integer, nullable: Active campaigns; null when not checked or unknown.
    - `next_action` 'pay_order' | 'wait_provisioning' | 'buy_or_connect_domains' | 'create_mailboxes' | 'start_warmup' | 'wait_warmup' | 'create_campaign' | 'ready', required
    - `next_step` string, required
    - `links` object, required
  - AccountWorkspaceChoiceOut
    - `workspaces` AccountWorkspaceOut[], required
      - `id` integer, required
      - `name` string, required
    - `next_action` 'select_workspace', required
    - `next_step` string, required
    - `links` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/6c02339eef43?raw)