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 locales[].locale (BCP-47). ISO 639-1 language code (e.g. en, fr, zh).
"en"
Locales this voice can speak. The native/source locale is first (is_native: true), followed by attached cross-lingual locales. Locale codes are BCP-47 language-region tags (for example en-US, es-MX).
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 Catalog accent id from GET /accents (e.g. southern-us). Display names are not returned on this API version.
abruzzo-italian, african-american, african-french, arabic, arabic-english, australian, bagheli, belgian-french, brazilian-portuguese, british, budapest, bulgarian, california, camba, campania, canadian-english, canadian-french, castilian, central-tamil, central-thai, central-vietnamese, chilean, colombian, czech, danish, european-portuguese, finnish, general-american, high-german, hindi, indian-english, indian-urdu, irish, israeli, istanbul, italian, jakarta, japanese, jessore, khaleeji, konkani, korean, kyiv, malay, mandarin, manila, mexican, middle-eastern-arabic, midwestern-american, modern-standard-arabic, moldovan, new-york, new-zealand, north-kerala, odia, oslo, parisian, parsi, peruvian, polish, powadhi, randstad, romanian, russian, singaporean, slovak, south-african, southern-us, southern-karnataka, southern-vietnamese, standard-japanese, stockholm, swiss-standard, taiwanese-mandarin, tbilisi, telangana, urdu, thessaloniki, zagreb "southern-us"
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.
Deprecated. Prefer locales[].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.