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

# List a provider's voices

> Returns all voices for one TTS provider with optional filtering by language, gender, accent and pagination.

Use this when you already know which provider you want and just need to browse/search its catalog. Same filters as the unified `/voices` endpoint.

## Example: ElevenLabs female English voices

```bash theme={null}
curl "https://eu-gcp-api.vg-stuff.com/v3/voices/elevenlabs?language=en&gender=female&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example: Deepgram Aura-2 voices only

```bash theme={null}
curl "https://eu-gcp-api.vg-stuff.com/v3/voices/deepgram?modelId=aura-2" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

<Tip>
  For providers with model-specific voice catalogs (`deepgram`, `rime-ai`), pass `modelId` to scope the listing.
</Tip>

<Note>
  The endpoint uses `workspaceData.secrets.<PROVIDER_KEY>` when present, otherwise the platform's server key. It does **not** consume credits.
</Note>


## OpenAPI

````yaml GET /voices/{provider}
openapi: 3.0.3
info:
  title: Convocore OpenAPI
  description: Full API reference for Convocore
  version: 1.0.4
servers:
  - url: https://eu-gcp-api.vg-stuff.com/v3
security: []
paths:
  /voices/{provider}:
    get:
      tags:
        - Voices
      summary: List voices for a single provider
      description: >-
        Returns all voices for one TTS provider, with optional filtering by
        `language`, `gender` and `accent`, plus pagination via `limit` &
        `offset`. Uses the workspace's API key for that provider when present in
        `workspaceData.secrets.*`, otherwise falls back to the platform-provided
        server key.
      operationId: v2Audio-listProviderVoices
      parameters:
        - name: provider
          in: path
          required: true
          schema:
            type: string
          description: Provider slug (e.g. elevenlabs)
        - name: language
          in: query
          required: false
          schema:
            type: string
        - name: gender
          in: query
          required: false
          schema:
            type: string
        - name: accent
          in: query
          required: false
          schema:
            type: string
        - name: modelId
          in: query
          required: false
          schema:
            type: string
        - name: sampleText
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/S_0cd3524d'
        - name: offset
          in: query
          required: false
          schema:
            anyOf:
              - not: {}
              - type: integer
                minimum: 0
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  provider:
                    type: string
                  total:
                    type: number
                  limit:
                    type: number
                  offset:
                    type: number
                  voices:
                    $ref: '#/components/schemas/array_7a66e46b'
                required:
                  - provider
                  - total
                  - limit
                  - offset
                  - voices
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - Authorization: []
components:
  schemas:
    S_0cd3524d:
      anyOf:
        - not: {}
        - type: integer
          minimum: 1
          maximum: 500
      default: 100
    array_7a66e46b:
      type: array
      items:
        $ref: '#/components/schemas/voiceId_name_provider_previewUrl_7f4373'
    voiceId_name_provider_previewUrl_7f4373:
      type: object
      properties:
        voiceId:
          type: string
        name:
          type: string
        provider:
          type: string
        previewUrl:
          type: string
        filters:
          $ref: '#/components/schemas/accent_gender_useCase_language_9df939'
      required:
        - voiceId
        - name
        - provider
        - previewUrl
        - filters
      additionalProperties: false
    message_11569e:
      type: object
      properties:
        message:
          type: string
      required:
        - message
      additionalProperties: false
    accent_gender_useCase_language_9df939:
      type: object
      properties:
        accent:
          type: string
        gender:
          type: string
        useCase:
          type: string
        language:
          type: string
      required:
        - accent
        - gender
        - useCase
        - language
      additionalProperties: false
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  $ref: '#/components/schemas/message_11569e'
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````