--- title: "Get Speaker Name Inference Suggestions Route" method: GET path: "/v2/audios/{audio_id}/speaker-name-inference/suggestions" tags: ["Audio Emotion API"] --- # Get Speaker Name Inference Suggestions Route `GET /v2/audios/{audio_id}/speaker-name-inference/suggestions` ## 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/v2/audios/{audio_id}/speaker-name-inference/suggestions` - Auth: one of: - API key in header `X-API-Key` - HTTP bearer Return the stored speaker-name inference suggestions for an audio. Populated automatically after a contact-center recording finishes processing, or after the recording is tagged as a contact-center call. Row shape matches `POST .../speaker-name-inference/suggestions`. No charge is applied for this stored block. 404 when no suggestions block is stored, when the speaker set has changed since it was generated, when an accepted name has been committed (that write clears the block; nothing re-runs it except tagging the audio as a contact-center call again), or when the audio is not a contact-center call. An all-rejected completed run still 200s. Committing a role does not update this proposal. Auth matches the trigger POST: owner or a caller holding `media:write`. This is not a share-link surface. ## Error Responses - **401 Unauthorized**: User is not authenticated or not authorized to access this audio - **404 Not Found**: Audio not found, no suggestions block is stored, the speaker set changed since generation, an accepted name was committed, or the audio is not a contact-center call ## Path parameters - `audio_id` string, required: Unique identifier of the audio. ## Response `200` Successful Response - SpeakerNameInferenceStoredSuggestionsResponse: Stored auto-run suggestions for ``GET .../speaker-name-inference/suggestions``. Row shape matches the suggestions POST (``results``). ``generated_at`` is the stored timestamp, or ``null`` when missing — never fabricated as now. ``video_id`` is ``null`` for audio-only media (empty-string storage normalizes to ``null``; the field is not omitted). - `generated_at` string, nullable - `audio_id` string, required - `video_id` string, nullable - `results` SpeakerNameInferenceResult[], required - `speaker_id` integer, required - `accepted` boolean, required - `name` string, nullable - `reason` string, nullable - `quote` string, nullable - `pattern` string, nullable - `role` 'agent' | 'customer', nullable: Proposed role. Present only when a role was accepted. - `role_accepted` boolean, nullable: True when the cited quote was found verbatim in a line this speaker spoke. The role itself is the model's judgement and is not verified. - `role_reason` string, nullable: Why the role was rejected. Omitted on accept. One of, checked in this order: role_already_set, insufficient_evidence, invalid_role, quote_too_short, quote_mismatch, wrong_speaker. - `role_quote` string, nullable: A quote from that speaker's own words that the model cited for the role. Present only when a role was accepted. ## Other responses - `401`: Missing, malformed or rejected credentials — no `X-API-Key` / `Authorization: Bearer `, an expired token, or a caller that lacks the role the route requires. Note that this API answers *authorization* failures with 401 as well as 403 (see the 403 entry where a route declares both). - `404`: No such resource, or it is not visible to this caller. Ownership failures are reported as 404 rather than 403 so the API does not confirm the existence of another account's records. - `422`: Validation Error ## Changes - **2026-09-08** `b10651168511`: 1 info - endpoint added [Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/audios/:audio_id/speaker-name-inference/suggestions/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)