> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account State

> One account's tier, owner, and discard flag

Returns a null `account_state` when the account has no state yet — every
account is queryable, and "no state" is a normal answer, not a 404.

The account's tags are a separate read:
[Get An Account's Tags](/api-reference/get-account-record-tags). A former status
is one of those tags.

## Path Parameters

<ParamField path="companyId" type="string" required>
  The account's `company_id` (the company UUID), from [List
  Accounts](/api-reference/list-accounts).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/account-states/9c4d5e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "account_state": {
        "company_id": "9c4d5e6f-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
        "tier_id": "1a2b3c4d-5e6f-4071-8a92-b3c4d5e6f708",
        "owner_id": null,
        "is_discarded": false,
        "notes": "",
        "updated_at": "2026-09-14T09:12:00Z",
        "updated_by": null
      }
    }
  }
  ```

  ```json 200 (no state yet) theme={null}
  {
    "success": true,
    "data": { "account_state": null }
  }
  ```
</ResponseExample>