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

> Your workspace's account tag vocabulary

The tags your workspace puts on companies, in display order.

**Read this before writing tags anywhere.** Assignments are by **id**, and the
ids only come from here.

## Account tags are not connector tags

They are separate vocabularies on purpose. Account tags label **companies**;
connector tags label **people**.
"Champion" on a person and "Champion" on a company are different claims, and one
merged list would mean every picker showing every tag anyone ever made for
anything, plus a delete whose effect crosses entities.

The cost is typing "Fintech" twice. The benefit is that each picker only offers
tags that make sense for the thing being tagged.

<Note>
  **Tags are what a grade cannot know.** `fit_grade` scores what the product can
  compute — your target list, your tiers, your ICP. "Common investor", "renewal
  Q3", "met them at SaaStr" are facts only your team has, and one Tags column
  holds all of them instead of one column per question.
</Note>

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

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

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

  by_name = {t["name"]: t["id"] for t in tags}
  ```

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "tags": [
        {
          "id": "7f3e1a22-...",
          "name": "Common investor",
          "color": "#3B82F6",
          "position": 0,
          "account_count": 14
        },
        {
          "id": "8a4f2b33-...",
          "name": "Renewal Q3",
          "color": "#F59F0A",
          "position": 1,
          "account_count": 3
        }
      ]
    }
  }
  ```

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