---
title: "List Contact Scores"
method: GET
path: "/api/contacts/scores"
tags: ["contacts", "contacts"]
---

# List Contact Scores

`GET /api/contacts/scores`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/contacts/scores`
- Auth: none declared

List contacts with their relationship scores and segments.

Returns all contacts with optional score data. Contacts without scores
will have score=null.

## Query parameters

- `segment` string, nullable: Filter by segment: strong, medium, low, noise, dormant
- `state` string, nullable: Filter by state: new, follow_up, active, warm, cooling, dormant, low
- `search` string, nullable: Search by name, phone, or email
- `channel` string, nullable: Filter by channel
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ContactScoreListResponse: Paginated list of contacts with scores.
  - `contacts` ContactWithScoreResponse[], required
    - `id` integer, required
    - `display_name` string, required
    - `avatar_url` string, nullable
    - `normalized_phone` string, nullable
    - `normalized_email` string, nullable
    - `channels` string[]
    - `score` ContactScoreResponse: Contact score breakdown.
      - `person_id` integer, required
      - `display_name` string, required
      - `signal_score` number, required
      - `recency_score` number, required
      - `frequency_score` number, required
      - `depth_score` number, required
      - `reciprocity_score` number, required
      - `context_score` number, required
      - `confidence` number, required
      - `confidence_factors` object
      - `segment` string, required
      - `is_dormant` boolean
      - `dormant_since` string, nullable
      - `last_interaction_at` string, nullable
      - `calculated_at` string, nullable
      - `contact_state` string, nullable
      - `state_reason_codes` string[]
      - `state_changed_at` string, nullable
      - `outreach_paused` boolean
      - `outreach_paused_reason` string, nullable
  - `total` integer, required
  - `counts` SrcApiContactsCountsResponse: Both state and segment counts.
    - `states` SrcApiContactsStateCounts: Count of contacts by Strategy Engine state.
      - `new` integer
      - `follow_up` integer
      - `active` integer
      - `warm` integer
      - `cooling` integer
      - `dormant` integer
      - `low` integer
    - `segments` SrcApiContactsSegmentCounts: Count of contacts by segment.
      - `strong` integer
      - `medium` integer
      - `low` integer
      - `noise` integer
  - `segment_summary` object

## Other responses

- `422`: Validation Error

---

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