---
title: "Get topic persons"
method: GET
path: "/topics/{topicId}/people"
tags: ["Topics", "People"]
---

# Get topic persons

`GET /topics/{topicId}/people`

## Request

- Base URL: `https://api.modem.dev/v1`
- URL: `https://api.modem.dev/v1/topics/{topicId}/people`
- Auth: HTTP bearer

Get unique persons participating in a topic, based on message authors linked via PersonIdentity. A topic archived in the v1 to v2 migration returns 404 with data.reason archived_in_v1_to_v2_migration.

## Path parameters

- `topicId` union, required
  - string, uuid
  - string, uuid

## Response `200`

OK

- object
  - `data` object[], required
    - `avatarUrl` string, nullable, required
    - `company` object, nullable, required
      - `domain` string, nullable, required
      - `id` string, required
      - `logoUrl` string, nullable, required
      - `name` string, required
    - `displayName` string, required
    - `id` string, required
    - `identities` object[], required
      - `platform` string, required
      - `platformId` string, required
    - `isBot` boolean, required
    - `isVip` boolean, required
    - `messageCount` number, required
    - `sources` string[], required
    - `title` string, nullable, required

## Other responses

- `400`: Invalid request (validation failed).
- `401`: Missing or invalid API key.
- `403`: The API key does not have access to this resource.
- `404`: The requested resource was not found.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

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