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

# Get Multiple Frame

`GET /v1/videos/{video_id}/frames`

API to Retrieve Frames of the video based on video_id.

## Path parameters

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

## Query parameters

- `start_frame` string — The frame number from which retrieval should begin. Defaults to the start of the video if not provided.
- `length` string — The number of frames to retrieve, starting from 'start_frame'. If omitted, all available frames will be returned.
- `face_ids` string — Optional comma-separated list of face IDs (e.g., '1,2,3')

## Response `200`

Successful Response

- MultipleFramesResponse — Model for returning the MultipleFrame Responses
  - `processed_frames` FramesResponse[], required
    - `original_frame_image` string
    - `frame_image` string
    - `found_faces` integer[]
    - `timestamp` integer
    - `faces` BoundingBox[]
    - `frame_id` integer
    - `note` string

## Other responses

- `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/4a61d1ac9025/schema)