---
title: "Get Image Emotion Analysis"
method: GET
path: "/v1/images/{image_id}"
tags: ["Image Emotion API"]
---

# Get Image Emotion Analysis

`GET /v1/images/{image_id}`

## 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/{image_id}`
- 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 detailed emotion analysis results and metadata for a specific uploaded image.
Includes detected faces, their emotional scores, image dimensions, and annotated visualizations.

## Path parameters

- `image_id` string, required: Unique ID of the image to retrieve.

## Response `200`

Successful Response

- ImageDBResponse: Detailed response model for image emotion stored in DB. Attributes: title (str): Title of the image. description (str): Description provided by the user. created_at (Any): Timestamp when image was added. original_frame_image (Any): Original image file. height (float): Height of the image. width (float): Width of the image. found_faces (int): Number of faces detected. faces (Any): Detailed face data. annotated_image (Any): Image with annotations (e.g., bounding boxes).
  - `id` string, required
  - `status` string, required
  - `title` string, required
  - `description` string, required
  - `created_at` unknown, required
  - `original_frame_image` unknown, required
  - `height` number, required
  - `width` number, required
  - `found_faces` integer[], required
  - `faces` unknown, required
  - `annotated_image` unknown, 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

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