---
title: "Get Video Emotion Insights"
method: GET
path: "/v1/videos/{video_id}"
tags: ["Video Emotion API"]
---

# Get Video Emotion Insights

`GET /v1/videos/{video_id}`

Get a single video details by ID

## Path parameters

- `video_id` string, required — The unique ID of the video to be fetched

## Response `200`

Successful Response

- VideoResponse — Model representing detailed video metadata and analysis. Attributes: title (Optional[str]): Title of the video. description (str): Description of the video. id (str): Unique video identifier. audio_id (str): Related audio ID if extracted. model_id (str): Model used to process video. emotions_list (List[str]): List of possible emotions. url (str): Original video file url faces (Optional[ListOfFaces]): Detected faces in the video. annotated_video_mp4 (Any): Processed video with annotations. summary (str): Summary text of the video. total_frames_count (Optional[int]): Total number of frames. fps (Optional[float]): Frames per second. height (Optional[float]): Height of the video. width (Optional[float]): Width of the video. status (str): Current processing status. created_at (str): Creation timestamp. thumbnail_image (str): URL or data of the thumbnail image. text_id (str): Linked text analysis ID.
  - `title` string
  - `description` string
  - `id` string, required
  - `audio_id` string
  - `model_id` string
  - `emotions_list` string[]
  - `url` string
  - `faces` ListOfFaces — Model representing a collection of faces. Attributes: faces (List[Faces]): List of detected or named faces.
    - `faces` Faces[], required
      - `image` string
      - `name` string, nullable
      - `face_id` integer, required
  - `annotated_video_mp4` unknown
  - `summary` string
  - `total_frames_count` integer, nullable
  - `fps` number, nullable
  - `height` number, nullable
  - `width` number, nullable
  - `status` string, required
  - `created_at` string
  - `thumbnail_image` string
  - `text_id` string

## Other responses

- `401` — Missing, malformed or rejected credentials — no `X-API-Key` / `Authorization: Bearer <jwt>`, an expired token, or a caller that lacks the role the route requires. Note that this API answers *authorization* failures with 401 as well as 403 (see the 403 entry where a route declares both).
- `404` — No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records.
- `422` — Validation Error

---

[API](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai.md) · [All operations](https://skmtc.net/imentiv/apis/welcome-to-imentiv-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/imentiv/welcome-to-imentiv-ai/revisions/350e9cbcb623/schema)