---
title: "Media · Generate · Get a voice by ID"
method: GET
path: "/api/v1/voices/{voice_id}"
tags: ["aiGeneration"]
---

# Media · Generate · Get a voice by ID

`GET /api/v1/voices/{voice_id}`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/voices/{voice_id}`
- Auth: API key in header `Authorization`

Retrieve a single voice by its UUID. Use this to resolve a bare
`voice_id` — one the user picked in a voice picker, or a saved
preference — back to its attributes without re-listing the whole
catalog: `gender` (0=Male, 1=Female, 3=Neutral), `voice_name`,
`is_premium`, `description`, and `supports_instructions` (whether the
voice honors the `instructions` hint on generateAudio).

The response is a single voice object — the same shape as one entry of
`listVoices`'s `voices[]`. Resolution is workspace-scoped: a voice owned
by another workspace (and not globally published) returns 404.

## Path parameters

- `voice_id` string, uuid, required

## Response `200`

The voice detail

- unknown

## Other responses

- `401`: Unauthorized
- `404`: Voice not found (or not accessible in this workspace/space)

---

[API](https://skmtc.dev/simplified/apis/platform.md) - [All operations](https://skmtc.dev/simplified/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/platform/revisions/0815a1ba1e4e?raw)