---
title: "Get Voice"
method: GET
path: "/v1/voices/{voice_id}"
tags: ["Voices"]
---

# Get Voice

`GET /v1/voices/{voice_id}`

Retrieve details of a specific voice by its ID.

## Path parameters

- `voice_id` integer, required

## Response `200`

Voice details.

- VoiceResponse
  - `id` integer — Unique numeric ID of the voice.
  - `name` string — Display name of the voice.
  - `voice_id` string — Provider-specific voice identifier used when configuring a bot.
  - `sample_url` string — URL to an audio sample of the voice.
  - `provider` string — TTS provider (e.g. 'elevenlabs', 'deepgram').
  - `gender` string — Gender of the voice (e.g. 'male', 'female').
  - `language` string — Primary language code.
  - `languages` string[] — All supported language codes.
  - `accent` string — Accent or regional variant, if applicable.
  - `age` string — Approximate age group (e.g. 'young', 'middle-aged').
  - `ethnicity` string — Ethnicity descriptor, if available.
  - `characteristics` string[] — Descriptive tags (e.g. 'warm', 'professional', 'energetic').
  - `description` string — Free-text description of the voice.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Invalid voice_id
- `404` — Voice not found

---

[API](https://skmtc.net/openmicai/apis/openmic-v1-external-api.md) · [All operations](https://skmtc.net/openmicai/apis/openmic-v1-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmicai/openmic-v1-external-api/revisions/71c32e6ffd95/schema)