---
title: "List people"
method: GET
path: "/people"
tags: ["People"]
---

# List people

`GET /people`

## Request

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

List people with aggregated message statistics across all their platform identities

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `sortBy` 'lastSeen' | 'messageCount'
- `sortOrder` 'asc' | 'desc'
- `ecosystemTags` string[]: Filter by ecosystem tags (OR match)
- `companyId` string: Filter to people currently associated with this company

## Response `200`

OK

- object
  - `data` object[], required
    - `avatarUrl` string, uri, nullable, required: Avatar image URL for the person.
    - `company` object, nullable, required
      - `domain` string, nullable, required
      - `id` string, required
      - `logoUrl` string, nullable, required
      - `name` string, required
    - `displayName` string, required: Display name for the person.
    - `id` string, required
    - `identities` object[], required
      - `platform` string, required
      - `platformId` string, required
    - `identityCount` integer, required
    - `isVip` boolean, required
    - `lastSeenAt` string, date-time, nullable
    - `latestTopic` object, nullable, required
      - `isV2` boolean, required
      - `lastMessageAt` string, date-time
      - `topicId` union, required
        - string, uuid
        - string, uuid
      - `topicTitle` string, required
      - `topicType` string, nullable, required
    - `messageCount` integer, required
    - `primaryEmail` string, email, nullable, required
    - `sources` string[], required
    - `title` string, nullable, required
    - `weeklyActivity` integer[], required
  - `limit` integer, required: The page size used for this response.
  - `page` integer, required: The 1-based page number returned.
  - `totalCount` integer, required: Total number of items matching the query, across all pages.

## 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)