> ## Documentation Index
> Fetch the complete documentation index at: https://docs.navtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Voices

> Returns all voices available under the specified provider. The returned `voice` field is used as the `voice` parameter when creating an avatar.



## OpenAPI

````yaml GET /api/open/v1/voice/list
openapi: 3.1.0
info:
  title: NavTalk API
  description: NavTalk API for AI avatar management, file uploads, and video generation
  version: 1.0.0
servers:
  - url: https://api.navtalk.ai
    description: NavTalk Production Environment Server
  - url: https://qaapi.navtalk.ai
    description: NavTalk QA Environment Server
  - url: https://devapi.navtalk.ai
    description: NavTalk Development Environment Server
security:
  - navtalkLicenseAuth: []
paths:
  /api/open/v1/voice/list:
    get:
      tags:
        - Voice
      summary: List Voices
      description: >-
        Returns all voices available under the specified provider. The returned
        `voice` field is used as the `voice` parameter when creating an avatar.
      operationId: listVoices
      parameters:
        - name: providerId
          in: query
          description: The provider ID (obtained from `/provider/list`)
          required: true
          schema:
            type: string
            example: b92a28fb2ea737457c7f13ba554759c0
      responses:
        '200':
          description: Voice list retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceListResponse'
              example:
                code: 200
                message: SUCCESS
                data:
                  - voice: CwhRBWXzGAHq8TQ4Fs17
                    name: Rachel
                    description: A calm and clear female voice
                    gender: female
                    url: https://example.com/voices/rachel-preview.mp3
        '400':
          description: License validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NavtalkErrorResponse'
              example:
                code: 400
                message: Invalid license key
      security:
        - navtalkLicenseAuth: []
components:
  schemas:
    VoiceListResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
          example: SUCCESS
        data:
          type: array
          items:
            $ref: '#/components/schemas/OpenVoice'
    NavtalkErrorResponse:
      type: object
      properties:
        code:
          type: integer
          example: 400
        message:
          type: string
          example: Invalid license key
    OpenVoice:
      type: object
      properties:
        voice:
          type: string
          description: Voice key, used as the `voice` field when creating an avatar.
          example: CwhRBWXzGAHq8TQ4Fs17
        name:
          type: string
          description: Display name of the voice.
          example: Rachel
        description:
          type: string
          description: Short description of the voice characteristics.
          example: A calm and clear female voice
        gender:
          type: string
          description: Gender of the voice.
          example: female
        url:
          type: string
          description: Audio preview URL for this voice.
          example: https://example.com/voices/rachel-preview.mp3
  securitySchemes:
    navtalkLicenseAuth:
      type: apiKey
      in: header
      name: license
      description: NavTalk API license key (e.g. sk_navtalk_...)

````