> ## Documentation Index
> Fetch the complete documentation index at: https://docs.convocore.ai/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
    description: EU Node.js API server
  - url: https://na-gcp-api.vg-stuff.com/v3
    description: NA Node.js API server
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:
            anyOf:
              - not: {}
              - type: integer
                minimum: 1
                maximum: 500
            default: 100
        - 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:
                    type: array
                    items:
                      type: object
                      properties:
                        voiceId:
                          type: string
                        name:
                          type: string
                        provider:
                          type: string
                        previewUrl:
                          type: string
                        filters:
                          type: object
                          properties:
                            accent:
                              type: string
                            gender:
                              type: string
                            useCase:
                              type: string
                            language:
                              type: string
                          required:
                            - accent
                            - gender
                            - useCase
                            - language
                          additionalProperties: false
                      required:
                        - voiceId
                        - name
                        - provider
                        - previewUrl
                        - filters
                      additionalProperties: false
                required:
                  - provider
                  - total
                  - limit
                  - offset
                  - voices
                additionalProperties: false
        default:
          $ref: '#/components/responses/error'
      security:
        - Authorization: []
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````