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

# List Voices for LLM Model

> List available voices for a specific LLM model.

### Authorizations

<ParamField header="X-Api-Key" type="string" required>
  Your Agni API key used to authenticate the request. Pass it in the `X-Api-Key` header.
</ParamField>

***

### Path Parameters

<ParamField path="llm_model_id" type="string" required>
  The unique ID of the LLM model to fetch voices for.
</ParamField>

***

### Query Parameters

<ParamField query="limit" type="integer">
  The maximum number of voice records to return. Example: `10`.
</ParamField>

<ParamField query="offset" type="integer">
  The number of voice records to skip before returning results. Example: `0`.
</ParamField>

***

### Request

```bash theme={null}
curl --location "https://api.ravan.ai/api/v1/available-voice-ids/{llm_model_id}/voices?limit=10&offset=0" \
  --header "X-Api-Key: YOUR_API_KEY"
```

***

### Response

<ResponseField name="success" type="boolean">
  Whether the request succeeded.
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable status message.
</ResponseField>

<ResponseField name="data" type="object[]">
  Voices available for the requested LLM model.

  <Expandable title="data[]">
    <ResponseField name="id" type="string">
      Unique voice ID. Use this value as the `voice_id` when creating or updating an agent.
    </ResponseField>

    <ResponseField name="llm_model_id" type="string">
      ID of the LLM model this voice belongs to.
    </ResponseField>

    <ResponseField name="real_voice_id" type="string">
      Provider-specific voice identifier. Example: `alloy`.
    </ResponseField>

    <ResponseField name="voice_name" type="string">
      Display name of the voice.
    </ResponseField>

    <ResponseField name="real_voice_name" type="string">
      Provider-specific voice name.
    </ResponseField>

    <ResponseField name="gender" type="string">
      Voice gender label.
    </ResponseField>

    <ResponseField name="language" type="string">
      Voice language code.
    </ResponseField>

    <ResponseField name="recording_url" type="string">
      URL for a sample recording.
    </ResponseField>

    <ResponseField name="img_url" type="string">
      URL for the voice image.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Pagination metadata.

  <Expandable title="meta">
    <ResponseField name="total" type="integer">
      Total number of voice records.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Limit used for the request.
    </ResponseField>

    <ResponseField name="offset" type="integer">
      Offset used for the request.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Voices fetched successfully",
    "data": [
      {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "llm_model_id": "550e8400-e29b-41d4-a716-446655440000",
        "real_voice_id": "alloy",
        "voice_name": "Alloy",
        "real_voice_name": "alloy",
        "gender": "female",
        "language": "en",
        "recording_url": "https://cdn.ravan.ai/voices/alloy.mp3",
        "img_url": "https://cdn.ravan.ai/voices/alloy.png"
      }
    ],
    "meta": {
      "total": 1,
      "limit": 10,
      "offset": 0
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/available-voice-ids/{llm_model_id}/voices
openapi: 3.0.1
info:
  title: Agni API
  version: 1.0.0
  description: >-
    Agni API for managing agents, tools, widget settings, telephony, and
    integrations.
servers:
  - url: https://api.ravan.ai
security:
  - X-Api-Key: []
tags:
  - name: AgentService
  - name: AgentToolService
  - name: WidgetSettingsService
  - name: PhoneService
  - name: AppointmentService
  - name: GHLService
  - name: CalComService
  - name: CampaignService
  - name: ContactService
  - name: CallingService
  - name: RAGService
  - name: ModelService
  - name: HealthService
paths:
  /api/v1/available-voice-ids/{llm_model_id}/voices:
    get:
      tags:
        - ModelService
      summary: List Voices for LLM Model
      description: List available voices for a specific LLM model.
      operationId: ListVoicesForLLMModel
      parameters:
        - name: llm_model_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: LLM model ID
        - name: limit
          in: query
          schema:
            type: integer
            format: int32
          description: The maximum number of voice records to return.
        - name: offset
          in: query
          schema:
            type: integer
            format: int32
          description: The number of voice records to skip before returning results.
      responses:
        '200':
          description: Voices fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListVoicesForLLMModelResponse'
components:
  schemas:
    ListVoicesForLLMModelResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/LLMModelVoice'
        meta:
          type: object
          properties:
            total:
              type: integer
            limit:
              type: integer
            offset:
              type: integer
    LLMModelVoice:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique voice ID
        llm_model_id:
          type: string
          format: uuid
          description: ID of the LLM model this voice belongs to
        real_voice_id:
          type: string
          description: Provider-specific voice identifier
        voice_name:
          type: string
          description: Display name of the voice
        real_voice_name:
          type: string
          description: Provider-specific voice name
        gender:
          type: string
          description: Voice gender label
        language:
          type: string
          description: Voice language code
        recording_url:
          type: string
          format: uri
          description: URL for a sample recording
        img_url:
          type: string
          format: uri
          description: URL for the voice image
  securitySchemes:
    X-Api-Key:
      type: apiKey
      in: header
      name: X-Api-Key

````