---
title: "List Videos"
method: GET
path: "/v1/videos"
tags: ["Video Emotion API"]
---

# List Videos

`GET /v1/videos`

## 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`
- 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`

Retrieves a paginated list of uploaded video files associated with the authenticated user.

## Query parameters

- `offset_video_id` string, nullable: The ID of the reference video from which to paginate forward/backward
- `page_size` integer: Number of results to return (default: 10)
- `direction` string: Pagination direction: forward (default) or backward

## Response `200`

Successful Response

- PaginatedResponse: Model for paginated audio emotion responses. Attributes: documents (List[AudioEmotionResponse]): List of audio responses. count (int): Total count of documents.
  - `documents` unknown, required
  - `count` integer, required

## 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
- **2026-08-20** `74ceee4a5c98`: 2 info
  - `query` request parameter `offset_video_id` list-of-types was widened by adding types `null`
  - for the `query` request parameter `offset_video_id`, the type was generalized from `string` to no type

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