---
title: "Get Audio Emotion Insights"
method: GET
path: "/v1/audios/{audio_id}"
tags: ["Audio Emotion API"]
---

# Get Audio Emotion Insights

`GET /v1/audios/{audio_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/audios/{audio_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`

Retrieve Single Audio based on audio_id.

## Path parameters

- `audio_id` string, required: The unique ID of the uploaded audio

## Response `200`

Successful Response

- Audio: Model representing audio metadata and analysis results. Attributes: created_at (Optional[Any]): Timestamp when the audio was created. status (str): Current processing status of the audio. id (str): Unique identifier for the audio. model_id (str): Models used to process audio. url (str): Storage URL of the audio file. audio_duration (float): Duration of the audio in seconds. task_completion_status (Optional[int]): Status code indicating task completion. user_id (str): ID of the user who uploaded the audio. title (Optional[str]): Optional title for the audio. average_audio_emotions (Optional[dict]): Average emotion scores for the audio. segment_audio_emotions (Optional[list[dict]]): Emotions per audio segment. segment_text_emotions (Optional[list[dict]]): Text-based emotions per segment. summary (Optional[Union[str, Dict[str, Any]]]): Text summary of the audio (string or dict with title, status, summary_body). speakers (Optional[list[dict]]): Detected speaker information. audio_type (str): Declared recording type. Always a string; generic when absent. llm_audio_policy (str): Backend-stamped audio-LLM policy. Always a string; off when absent.
  - `created_at` unknown
  - `status` string, required
  - `id` string, required
  - `model_id` string
  - `url` string, required
  - `audio_duration` number, required
  - `task_completion_status` integer, nullable
  - `user_id` string, required
  - `title` string, nullable
  - `average_audio_emotions` object, nullable
  - `segment_audio_emotions` object[], nullable
  - `segment_text_emotions` object[], nullable
  - `summary` union
    - string
    - object
  - `speakers` object[], nullable
  - `audio_type` string
  - `llm_audio_policy` string

## 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-09-08** `b10651168511`: 2 info
  - added the optional property `audio_type` to the response with the `200` status
  - added the optional property `llm_audio_policy` to the response with the `200` status

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