---
title: "List Account Status"
method: GET
path: "/gtm-internal/account-status"
tags: ["gtm-internal"]
---

# List Account Status

`GET /gtm-internal/account-status`

## Request

- Base URL: `https://api-v1.unusual.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-v1.unusual.ai/gtm-internal/account-status`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Account Status board — one row per `account` SPINE row under a required
lifecycle lens (default "book": the working CRM book, i.e. everything minus
the prospect scouting tier). `owner` scopes the tier: a handle → that CEM's
book (exact, case-insensitive), `owner="none"` → unowned accounts (the
pick-me-up view), unset → everyone. Enriched with the JTBD goal, lifecycle
fields, and a Work-track progress %% derived live from system state. Spine
guardrail: the scan is always status-scoped (indexed) and hard-capped at
_ACCOUNT_STATUS_ROW_CAP rows — the lens tiers are small today (≤~150), so
rows are built then sorted/paged in memory, which keeps the derived
progress %% sortable.

## Query parameters

- `status` string
- `q` string, nullable
- `owner` string, nullable
- `intro_source` string, nullable
- `sort_by` string
- `sort_dir` string
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- AccountStatusListResponse
  - `rows` AccountStatusRow[], required
    - `account_id` string, required
    - `org_id` string, nullable
    - `domain_id` string, nullable
    - `status` string, required
    - `account` string, required
    - `domain_host` string, nullable
    - `domain_url` string, nullable
    - `owner` string, nullable
    - `jtbd` string, nullable
    - `jtbd_goal_id` string, nullable
    - `stage` string, nullable
    - `journey_phase` string, nullable
    - `account_type` string, nullable
    - `agency_mediated` boolean
    - `intro_source` string, nullable
    - `segment` string, nullable
    - `last_touch` string, nullable
    - `last_signal_at` string, nullable
    - `signal_count_30d` integer, nullable
    - `notes` string, nullable
    - `work_progress_pct` integer, nullable
    - `work_milestones` AccountStatusMilestone[]
      - `key` string, required
      - `label` string, required
      - `done` boolean, required
      - `at` string, nullable
    - `priority_count` integer
    - `open_task_count` integer
  - `total` integer, required
  - `status` string, required
  - `page` integer
  - `page_size` integer
  - `truncated` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/unusual/apis/dashboard-server.md) - [All operations](https://skmtc.dev/unusual/apis/dashboard-server/llms.txt) - [OpenAPI document](https://skmtc.dev/unusual/apis/dashboard-server/revisions/89f716930ead?raw)
