---
title: "List the people the recordings list can be filtered by"
method: GET
path: "/v1/meetings/recordings/people"
tags: ["meetings"]
---

# List the people the recordings list can be filtered by

`GET /v1/meetings/recordings/people`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/meetings/recordings/people`
- Auth: HTTP bearer

The owner and participant options for the Meetings filters, so the dashboard offers real names instead of asking anyone to type an id. Owners come from the recording's own owner; participants are the speaker labels on the transcripts. Both are scoped to the recordings this caller can see.

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- MeetingFilterPeopleResponse: The people the Meetings list can be filtered by, so the UI never asks anyone to type an id.
  - `owners` MeetingOwnerOption[]
    - `actor_id` string, uuid, required
    - `name` string, required: The person's display name: what the picker shows.
    - `email` string, nullable: Their email, shown under the name to tell namesakes apart.
    - `meeting_count` integer, required: How many visible recordings they own.
  - `participants` MeetingParticipantOption[]
    - `name` string, required: The speaker label as it appears in the transcripts.
    - `meeting_count` integer, required: How many visible recordings they spoke in.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden. Inspect response body `code` for the specific reason (for example: PERMISSION_DENIED, EMAIL_NOT_VERIFIED, TENANT_ACCESS_REQUIRED, ROLE_UNRESOLVED)
- `404`: Not found
- `422`: Validation error

---

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