---
title: "Get voice details by ID"
method: GET
path: "/v1/voices/{voice_id}"
tags: ["voices"]
---

# Get voice details by ID

`GET /v1/voices/{voice_id}`

Gets detailed information about a specific voice by its voice ID. Only supports preset voices.

## Path parameters

- `voice_id` string, required

## Response `200`

Voice details retrieved successfully

- GetCharacterByIdResponse
  - `voice_id` string, required — Unique identifier for the voice
  - `name` string, required — Name of the voice
  - `description` string, nullable — Description of the voice
  - `age` string, required — Age of the voice
  - `gender` string, required — Gender of the voice
  - `use_case` string, required — Use case of the voice
  - `use_cases` string[], required — Use cases of the voice (array)
  - `language` string[], required — Languages supported by the voice
  - `styles` string[], required — Styles available for the voice
  - `models` string[], required — Models available for the voice
  - `samples` APISampleData[] — URL to the sample audio file for the voice
    - `language` string, required — Language of the sample
    - `style` string, required — Style of the sample
    - `model` string, required — Model of the sample
    - `url` string, required — URL to the sample audio file
  - `thumbnail_image_url` string — URL to the thumbnail image for the voice

## Other responses

- `401` — Unauthorized: Invalid API key
- `404` — Not Found: Voice not found or not accessible with the provided API key
- `500` — Internal Server Error: Failed to get voices

---

[API](https://skmtc.net/supertoneapi/apis/supertone-public-api.md) · [All operations](https://skmtc.net/supertoneapi/apis/supertone-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supertoneapi/supertone-public-api/revisions/1ac6d0957e70/schema)