---
title: "List Video Persons"
method: GET
path: "/v2/videos/{video_id}/persons"
tags: ["Media Persons"]
---

# List Video Persons

`GET /v2/videos/{video_id}/persons`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v2/videos/{video_id}/persons`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

People named on this video.

Includes someone named here who is also attached to the video's audio.
A person with no face or speaker yet is included. People stored on the
audio are not a separate list: a linked audio uses this video.

## Path parameters

- `video_id` string, required

## Response `200`

Successful Response

- MediaPersonListResponse: People named on this video or audio.
  - `persons` MediaPerson[], required
    - `person_id` string, required
    - `scope` 'media'
    - `media_type` 'video' | 'audio', required: Home this person is stored on. Use this in the update path.
    - `media_id` string, required: Home id. Use this id, not the page you listed from, when you update.
    - `name` string, required
    - `appearances` MediaAppearance[]
      - `video_id` string, nullable: Video this appearance is on.
      - `audio_id` string, nullable: Standalone audio this appearance is on.
      - `face_id` integer, nullable: Face on the video.
      - `speaker_id` integer, nullable: Speaker attached to this person.
      - `linked_at` string, date-time, required
      - `linked_by` string, nullable: Account that attached this appearance. Absent when the viewer is not signed in.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-01** `72330e2229c7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/videos/:video_id/persons/get.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)