List Voices

June 5, 2026 (November 16, 2026)

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

List both system voices (the 30 built-in TTS presets) and user voices (custom voices created via POST /voices) for an account.

This endpoint is intentionally fast — it does NOT resolve playback URLs for user voices. If you need an audioUrl to play a specific user voice, call GET /voices/ref for the single voice you want to play. System voices have a static sampleUrl on the response (gstatic.com asset, never expires).

https://api.useapi.net/v1/google-flow/voices

Request Headers

Authorization: Bearer {API token}

Query Parameters

  • email — required. Account whose voices to list.
  • source — optional filter. One of system, user. Omit to get both.

Responses

  • 200 OK

    {
      "voices": [
        {
          "voice": "Achernar",
          "source": "system",
          "displayName": "Achernar",
          "sampleUrl": "https://www.gstatic.com/aitestkitchen/voices/samples/Achernar.wav"
        },
        {
          "voice": "user:12345-email:6a6f...-voice:d990a2f9-...-mid:d55b6d59-...",
          "source": "user",
          "displayName": "Cheerful Narrator",
          "workflowId": "d990a2f9-...",
          "mediaId": "d55b6d59-...",
          "baseVoice": "Achernar",
          "dialog": "Hello, this is a test voice.",
          "voicePerformance": "Cheerful, energetic delivery",
          "createTime": "2026-06-05T18:25:32.847291Z"
        }
      ]
    }
    

    Notes:

    • system voices ship with a static sampleUrl (always playable, no expiration).
    • user voices do not include audioUrl here. Hit GET /voices/ref to get a fresh signed audioUrl for the one you want to play.
    • If no user voices have been created yet, the user section is just empty — no error.
  • 400 Bad Request

    {
      "error": "Parameter email is required",
      "code": 400
    }
    
  • 404 Not Found

    {
      "error": "Google Flow account john@gmail.com not found",
      "code": 404
    }
    

Model

The 30 system voice presets first, then the account’s own voices, each with its reference-id and name.

The list of voices, field by field
{
  voices: Array<                   // the 30 system voice presets (source system) first, then the account's own voices made
                                   // with POST /voices (source user). The source query parameter keeps one kind. The list
                                   // has no audioUrl: GET /voices/{ref} returns it for a user voice
    | {
        voice: string              // base preset name (e.g. "Achernar")
        source: 'system'           // a system voice preset
        displayName: string        // same as voice
        sampleUrl: string          // a static Google link that does not expire
      }
    | {
        voice: string              // reference-id for subsequent calls
        source: 'user'             // a custom voice (POST /voices)
        displayName: string        // the voice's name ('Untitled Voice' when it has none)
        workflowId: string         // Google Flow workflow of the voice
        mediaId: string            // media id of the voice's audio
        baseVoice?: string         // system preset the user voice derives from, when Google reports it
        dialog?: string            // the text the voice speaks in its sample
        voicePerformance?: string  // the delivery style
        createTime?: string        // ISO 8601 timestamp
      }
  >
}

Examples

  • # All voices
    curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         "https://api.useapi.net/v1/google-flow/voices?email=john@gmail.com"
    
    # Only user voices
    curl -H "Authorization: Bearer YOUR_API_TOKEN" \
         "https://api.useapi.net/v1/google-flow/voices?email=john@gmail.com&source=user"
    
  • const r = await fetch(
      `https://api.useapi.net/v1/google-flow/voices?email=${email}&source=user`,
      { headers: { 'Authorization': `Bearer ${token}` } }
    )
    const { voices } = await r.json()
    console.log(voices.map(v => v.displayName))
    
  • import requests
    r = requests.get(
        'https://api.useapi.net/v1/google-flow/voices',
        headers={'Authorization': f'Bearer {token}'},
        params={'email': 'john@gmail.com', 'source': 'user'},
    )
    for v in r.json()['voices']:
        print(v['displayName'], '→', v['voice'])
    

Try It