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

# List voices

> List actual voice models from a specific provider with optional filters (language, gender, search). Returns live data from voice providers like ElevenLabs, Azure Speech, and Cartesia.



## OpenAPI

````yaml https://api.itellico.ai/v1/openapi.json get /v1/accounts/{account_id}/providers/voices
openapi: 3.1.0
info:
  title: itellicoAI API v1
  version: 1.0.0
  description: >-
    Public REST API for managing accounts, agents, telephony resources, and
    conversations.


    Authentication is via API key in the `X-API-Key` header.
  termsOfService: https://itellico.ai/legal/terms-and-conditions/
  contact:
    name: itellicoAI Support
    email: support@itellico.ai
  license:
    name: Proprietary
servers:
  - url: https://api.itellico.ai
    description: Production
security:
  - APIKeyAuth: []
tags:
  - name: Accounts
    description: >-
      Identify the current account context and fetch core account metadata to
      bootstrap API usage.
  - name: Subaccounts
    description: >-
      Create and manage child accounts under a parent to model tenant
      hierarchies and delegated access.
  - name: Agents
    description: >-
      Define and configure conversational agents (model, transcriber, voice,
      behavior) used in calls and automations.
  - name: Providers
    description: >-
      Discover available AI model, transcriber, and voice catalogs for the
      current account when configuring agents.
  - name: Phone Numbers
    description: >-
      Manage BYOC phone numbers bound to your account; route inbound calls to
      agents and enable outbound calling.
  - name: SIP Trunks
    description: >-
      Manage BYOC SIP trunk connectivity (origination/termination endpoints and
      allowed IPs) used by phone numbers.
  - name: Calls
    description: >-
      Create, list, inspect, and connect voice calls across phone and web
      channels.
  - name: Conversations
    description: List and inspect conversation activity across web and telephony channels.
  - name: Analytics
    description: Usage analytics and reporting endpoints for conversation activity.
paths:
  /v1/accounts/{account_id}/providers/voices:
    get:
      tags:
        - Providers
      summary: List voices
      description: >-
        List actual voice models from a specific provider with optional filters
        (language, gender, search). Returns live data from voice providers like
        ElevenLabs, Azure Speech, and Cartesia.
      operationId: listVoices
      parameters:
        - in: path
          name: account_id
          schema:
            title: Account Id
            type: string
          required: true
        - in: query
          name: provider
          schema:
            description: 'Voice provider (required): elevenlabs, azure, or cartesia'
            title: Provider
            type: string
          required: true
          description: 'Voice provider (required): elevenlabs, azure, or cartesia'
        - in: query
          name: language
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by language code (e.g., 'en-us', 'fr-fr')
            title: Language
          required: false
          description: Filter by language code (e.g., 'en-us', 'fr-fr')
        - in: query
          name: gender
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Filter by gender: male, female, or neutral'
            title: Gender
          required: false
          description: 'Filter by gender: male, female, or neutral'
        - in: query
          name: search
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Search in voice name or description
            title: Search
          required: false
          description: Search in voice name or description
        - in: query
          name: limit
          schema:
            anyOf:
              - type: integer
              - type: 'null'
            description: Maximum number of voices to return
            title: Limit
          required: false
          description: Maximum number of voices to return
        - in: query
          name: refresh
          schema:
            default: false
            description: Clear cache and fetch fresh data from provider
            title: Refresh
            type: boolean
          required: false
          description: Clear cache and fetch fresh data from provider
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response
                type: object
      security:
        - APIKeyAuth: []
components:
  securitySchemes:
    APIKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````