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

# Get Voice

`GET /voices/{id}`

## Path parameters

- `id` string, required — The ID of the voice. Find one in the [Voice Library](https://play.cartesia.ai/voices) or via [List Voices](/api-reference/voices/list).

## Query parameters

- `expand[]` VoiceExpandOptions[], nullable

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- Voice
  - `id` string, required — The ID of the voice. Find one in the [Voice Library](https://play.cartesia.ai/voices) or via [List Voices](/api-reference/voices/list).
  - `is_owner` boolean, required — Whether your organization owns the voice.
  - `access` object, required — Who can access and list the voice
    - `type` 'private' | 'public', required — Who can use the voice: - `private`: only your organization can use the voice - `public`: anyone can use the voice
    - `visibility` 'owner' | 'all', required — Who sees the voice when using the [list endpoint](/api-reference/voices/list): - `owner`: only your organization sees the voice listed - `all`: all users see the voice listed
  - `name` string, required — The display name of the voice. Does not include the tagline.
  - `tagline` string, required — A short descriptor for the voice (at most 32 characters). Empty string when unset.
  - `description` string, required — A description for the voice, typically longer than the tagline if both are provided.
  - `gender` 'masculine' | 'feminine' | 'gender_neutral'
  - `created_at` string, date-time, required — The date and time the voice was created.
  - `preview_file_url` string, nullable — A URL to download a preview audio file for this voice. Useful to avoid consuming credits when looking for the right voice. The URL requires the same Authorization header. Voice previews may be changed, moved, or deleted so you should avoid storing the URL permanently. This property will be null if there's no preview available. Only included when `expand[]` includes `preview_file_url`.
  - `language` string, required — The voice's language, as an ISO 639-1 code (e.g. `en`, `fr`, `zh`)
  - `country` string — The country associated with the voice, as an ISO 3166-1 alpha-2 code when available (e.g. `US`, `GB`, `FR`).
  - `is_pro` boolean — Whether this voice is a pro voice clone.
  - `is_public` boolean, required — Use `access` instead. Whether the voice is publicly accessible.
  - `mode` string — No longer used.

---

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