List Account Tiers

GET

tenant-tiers

curl "https://api.clustr-ai.com/api/public/tenant-tiers" \
  -H "Authorization: Bearer YOUR_API_KEY"

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)

await fetch("https://api.clustr-ai.com/api/public/tenant-tiers", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "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 }
    ]
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

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 and Set Target Account Tier both take the name, and both reject one your workspace does not have rather than creating it.

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.

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.

curl "https://api.clustr-ai.com/api/public/tenant-tiers" \
  -H "Authorization: Bearer YOUR_API_KEY"

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)

await fetch("https://api.clustr-ai.com/api/public/tenant-tiers", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "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 }
    ]
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

curl "https://api.clustr-ai.com/api/public/tenant-tiers" \
  -H "Authorization: Bearer YOUR_API_KEY"

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)

await fetch("https://api.clustr-ai.com/api/public/tenant-tiers", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "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 }
    ]
  }
}

{
  "success": false,
  "error": {
    "message": "Invalid or missing API key",
    "code": "UNAUTHORIZED"
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

List Account Tiers