---
title: "Fetch Highlight Video"
method: GET
path: "/v1/videos/{video_id}/highlights"
tags: ["Video Emotion API"]
---

# Fetch Highlight Video

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

## 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/v1/videos/{video_id}/highlights`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.imentiv.ai/oauth/authorize`
    - Token URL: `https://api.imentiv.ai/oauth/token` scopes: `media.read`

API endpoint for highlight generation of a video.

## Path parameters

- `video_id` string, required: The video id to get the highlight video url

## Response `200`

Successful Response

- HighlightResponse: Model for highlight video response. Attributes: message (str): Status or success message. highlight_url (str): URL to the generated highlight video.
  - `highlight_status` string, nullable
  - `highlight_url` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-22** `536bf48bb9fb`: 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
  - the endpoint scheme security `OAuth2Delegated` was added to the API

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v1/videos/:video_id/highlights/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)