---
title: "Get Members"
method: GET
path: "/api/lists/{list_id}/members"
tags: ["KOL Lists"]
---

# Get Members

`GET /api/lists/{list_id}/members`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/lists/{list_id}/members`
- Auth: HTTP bearer

Return the list as a single decision surface (GitHub #376).

ONE call yields everything the decision UI needs: per-member identity,
core stats, a 0-100 fit score + red/positive flags, growth trend,
tier + price range, contact completeness, the list-local
``triage_state``, and the CRM-derived ``outreach`` block (null when
the member has no conversation). ``entries`` is sorted by
``fit.score`` descending — the strongest candidate first — and a
top-level ``rollup`` summarises the batch.

The active workspace is resolved so the CRM outreach join + the
cached brand-fit recommendation score can be included. If resolution
fails the surface still returns — it just omits the workspace-scoped
fields rather than collapsing the whole view.

## Path parameters

- `list_id` string, required

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Response `200`

Successful Response

- MemberListOut: Response for ``GET /api/lists/{id}/members`` — the decision surface.
  - `list_id` string, required
  - `list_name` string, required
  - `rollup` ListDecisionRollup, required: Top-level decision rollup — answers "what does this batch look like?" so the detail UI renders a header without scanning rows.
    - `total_members` integer
    - `n_untriaged` integer
    - `n_shortlisted` integer
    - `n_passed` integer
    - `n_pursuing` integer
    - `n_red_flag` integer
    - `n_missing_contact` integer
    - `total_estimated_price_min` number
    - `total_estimated_price_max` number
  - `entries` MemberDecisionOut[], required
    - `username` string, required
    - `added_at` string, nullable
    - `identity` MemberIdentityOut, required
      - `username` string, required
      - `display_name` string, nullable
      - `avatar_url` string, nullable
      - `verified` boolean
      - `platform` string, nullable
    - `stats` MemberStatsOut, required
      - `follower_count` integer, nullable
      - `avg_views` number, nullable
      - `avg_engagement_rate` number, nullable
      - `authenticity_score` integer, nullable
      - `recommendation_score` integer, nullable
    - `fit` FitOut, required
      - `score` integer, required
      - `flags` FitFlagOut[]
        - `code` string, required
        - `severity` string, required
        - `detail` string, required
    - `trend` MemberTrendOut, required: Growth trend from the two most-recent ``KOLSnapshot`` rows.
      - `follower_delta` integer, nullable
      - `follower_delta_pct` number, nullable
      - `er_delta` number, nullable
      - `trend_label` string, nullable
    - `pricing` MemberPricingOut, required
      - `tier` string, nullable
      - `estimated_price_min` number, nullable
      - `estimated_price_max` number, nullable
    - `contact` MemberContactOut, required
      - `email` string, nullable
      - `phone` string, nullable
      - `website` string, nullable
      - `instagram` string, nullable
      - `youtube` string, nullable
      - `linktree_url` string, nullable
      - `has_email` boolean
      - `has_website` boolean
      - `is_complete` boolean
    - `triage_state` string, required
    - `pursuing` boolean
    - `outreach` MemberOutreachOut: CRM-derived outreach status. Null on a member with no ``DBKolConversation``. The list never stores this — it is the CRM's.
      - `conversation_id` string, required
      - `status` string, required
      - `last_event_at` string, nullable
    - `tags` string, nullable
    - `notes` string, nullable

## Other responses

- `422`: Validation Error

---

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