---
title: "List Images"
method: GET
path: "/v1/images"
tags: ["Image Emotion API"]
---

# List Images

`GET /v1/images`

## 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/images`
- 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 all uploaded or processed images.
Use this endpoint to browse through image records based on their ID, status, and title.

## Query parameters

- `start_after` string, nullable: ID of the last image from the previous page. Fetches results after this ID.
- `page_size` integer: Number of results to return per page. The default is 10.
- `direction` string: Pagination direction: 'forward' or 'backward'. Default is 'forward'

## 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 `start_after` list-of-types was widened by adding types `null`
  - for the `query` request parameter `start_after`, the type was generalized from `string` to no type

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