---
title: "Get Contact Summary"
method: GET
path: "/api/contacts/{person_id}/summary"
tags: ["contacts", "contacts"]
---

# Get Contact Summary

`GET /api/contacts/{person_id}/summary`

## 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/{person_id}/summary`
- Auth: none declared

Get unified summary for a contact.

Aggregates all thread summaries with this person into a single
contact profile with relationship type, topics, pain points, etc.

Args:
    person_id: Contact person ID
    generate: If True, generate summary if it doesn't exist
    force_refresh: If True, force regeneration even if not stale

## Path parameters

- `person_id` integer, required

## Query parameters

- `generate` boolean: Generate if not exists
- `force_refresh` boolean: Force regeneration

## Response `200`

Successful Response

- ContactSummaryResponse: Unified contact summary.
  - `person_id` integer, required
  - `display_name` string, required
  - `summary` string, nullable
  - `key_topics` string[]
  - `relationship_type` string, nullable
  - `pain_points` string[]
  - `key_decisions` string[]
  - `shared_events` string[]
  - `first_interaction_at` string, nullable
  - `last_interaction_at` string, nullable
  - `total_threads` integer
  - `total_messages` integer
  - `version` integer
  - `model_name` string, nullable

## 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/77bef09a9209?raw)