Overview

Get Voice

Returns a single registered voice - its display name, profile image and provider ID - for a voice-detail or edit screen. It only ever resolves voices belonging to the signed-in listener, so it cannot be used to look up someone else's.

Use this when: you already hold a TunedVoiceId and need just that one voice. To render a picker, use Get My Voices rather than calling this per row.

Security Model

oAuth

Header Parameters

Authorizationstring Required

Access token issued by Tuned Global for authorization using oAuth 2.0

StoreIdstring Required

API Key provided by Tuned Global for accessing the service

Path Parameters

tunedVoiceIdstring Required

The internal identifier of the voice, as returned in TunedVoiceId by Get My Voices.

Response

200

Object

The single voice, in the same shape as one entry of Get My Voices.

Response Attributes

TunedVoiceIdstring

VoiceIdstring

Aliasstring

ImageUrlstring

400

Object

The identifier was blank.

404

Object

No such voice for this listener, or it has been deleted.

Sections

Get Voice

Security Model

Header Parameters

Path Parameters

Response

Response Attributes

Response