> ## 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.

# List Account Tiers

> Your workspace's account tiers, in rank order

Returns the tiers your workspace sorts accounts into, ordered by rank.
`position` 0 is the highest.

**Read this before writing a tier anywhere.** Tier names are chosen per
workspace: "A / B / C" for one customer, "Strategic / Growth / Watch" for the
next. [Create Target Account](/api-reference/create-target-account) and
[Set Target Account Tier](/api-reference/set-target-account-tier) both take the
name, and both reject one your workspace does not have rather than creating it.

<Note>
  **Tiers are managed in the app**, under Targeting → Tiering, where they are
  named, reordered and deleted. This endpoint is read-only: vocabulary is a
  deliberate decision, and a typo arriving over the API should not become a
  permanent tier.
</Note>

<Note>
  **Rank carries meaning.** The app colours a tier by its `position` rather than
  by a stored colour, which is why there is no colour field here and why
  reordering tiers repaints the tables. Position 0 is the top tier.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/tenant-tiers" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  tiers = requests.get(
      "https://api.clustr-ai.com/api/public/tenant-tiers",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  ).json()["data"]["tiers"]

  top = next(t["name"] for t in tiers if t["position"] == 0)
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://api.clustr-ai.com/api/public/tenant-tiers", {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "tiers": [
        { "id": "7f3e1a22-...", "name": "Tier 1", "position": 0 },
        { "id": "8a4f2b33-...", "name": "Tier 2", "position": 1 },
        { "id": "9b5a3c44-...", "name": "Tier 3", "position": 2 }
      ]
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": {
      "message": "Invalid or missing API key",
      "code": "UNAUTHORIZED"
    }
  }
  ```
</ResponseExample>