Get Voice
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
2026-08-14 "2026-08-14"
Path Parameters
The ID of the voice. Find one in the Voice Library or via List Voices.
Query Parameters
Additional fields to include in the response.
preview_file_url Response
The ID of the voice. Find one in the Voice Library or via List Voices.
Whether your organization owns the voice.
Who can use the resource. private means only the owner can use the resource. public means everyone can use the resource.
private, public The display name of the voice. Does not include the tagline.
A short descriptor for the voice (at most 32 characters). Empty string when unset.
A description for the voice, typically longer than the tagline if both are provided.
The date and time the voice was created.
Deprecated. Prefer accents[].locale (BCP-47). ISO 639-1 language code (e.g. en, fr, zh).
"en"
When the resource is returned by the list endpoint. owner means the resource appears for the owner only. all means the resource appears for all users.
owner, all The gender of the voice, if specified.
masculine, feminine, gender_neutral 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.
Accents this voice can speak. accent is a catalog id from GET /accents. The native/source accent is first (is_native: true), followed by attached cross-lingual accents. Omitted when the voice has none.
Deprecated. Prefer accents[].locale (BCP-47). ISO 3166-1 alpha-2 country code when available (e.g. US, GB, FR).
"US"
Whether this voice is a pro voice clone.