---
title: "List the tenant's creator roster (free)"
method: GET
path: "/creators/roster"
---

# List the tenant's creator roster (free)

`GET /creators/roster`

## Request

- Base URL: `https://creatorscore.io/api/v1`
- URL: `https://creatorscore.io/api/v1/creators/roster`
- Auth: API key in header `X-API-Key`

The authenticated tenant's saved creators — the same list as the brand dashboard, grouped into footprints (one creator = one entry across platforms), each with its unified CreatorScore and the TITLES of any active risk flags (never just a count). FREE and read-only: cached data only, never scrapes, scores, or charges.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

tenant_id + total + count + limit + offset + roster[] (each footprint: identity_group_id, display_name, score, tier, total_followers, platforms[], last_scored_at, age_days, is_stale, monitoring_active, plan (recurring | recurring_monitoring | null), plan_billing (api_credits | dashboard | contract | null), plan_renews_at, plan_paused_reason, risk_flags {count, titles, items}, public_profile_url).

- object

## Other responses

- `401`: Missing or invalid API key.
- `429`: Per-key rate limit hit (120 req/min). Retry after the duration in the Retry-After header.

---

[API](https://skmtc.dev/creatorscore/apis/creatorscore-api.md) · [All operations](https://skmtc.dev/creatorscore/apis/creatorscore-api/llms.txt) · [OpenAPI document](https://skmtc.dev/creatorscore/apis/creatorscore-api/revisions/d3a219842277?raw)