---
title: "Get a voice design"
method: GET
path: "/voice_designs/{id}"
tags: ["Voice Designs"]
---

# Get a voice design

`GET /voice_designs/{id}`

Returns the latest version of a voice design, or a specific version when `?version=N` is provided. The `id` parameter accepts either a UUID or the design name.

## Path parameters

- `id` string, required

## Query parameters

- `version` integer

## Response `200`

The requested voice design.

- VoiceDesignResponse — Response envelope for a single voice design with full version detail.
  - `data` VoiceDesignData — A voice design object with full version detail.
    - `record_type` 'voice_design' — Identifies the resource type.
    - `id` string, uuid — Unique identifier for the voice design.
    - `name` string — Name of the voice design.
    - `version` integer — Version number of this voice design.
    - `text` string — Sample text used to synthesize this version.
    - `prompt` string — Natural language prompt used to define the voice style for this version.
    - `voice_sample_size` integer — Size of the voice sample audio in bytes.
    - `version_created_at` string, date-time — Timestamp when this specific version was created.
    - `created_at` string, date-time — Timestamp when the voice design was first created.
    - `updated_at` string, date-time — Timestamp when the voice design was last updated.
    - `provider` 'telnyx' | 'minimax' | 'null', nullable — Voice synthesis provider used for this design.
    - `provider_supported_models` string[] — List of TTS model identifiers supported by this design's provider (e.g. `Qwen3TTS`, `speech-02-turbo`).
    - `provider_voice_id` string, nullable — Provider-specific voice identifier. For Telnyx designs this is the design version ID; for Minimax it is the Minimax-assigned voice ID.

## Other responses

- `401` — Unauthorized — missing or invalid bearer token.
- `404` — Voice design not found.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)