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

# List Speech-to-Speech Voices

> List voices for speech-to-speech agents.

Read only
Returns Speech to Speech voices with the languages and realtime LLM paths each voice supports. Use this endpoint when building a Speech to Speech voice selector or validating an agent configuration before saving it.

## When to use this

* **Building S2S agents**: agents with `pipeline_type: "Speech_To_Speech"` can only use voices from this list, not the general [List Voices](https://dialnexa.com/docs/api-reference/v1/voices/list.md) catalog.
* **Voice selectors**: populate the voice dropdown in your own tooling when the operator has chosen the Speech to Speech pipeline.
* **Pre-save validation**: confirm the voice, language, and realtime LLM combination is supported before creating or publishing the agent.

The API-key response is a root JSON array containing the full voice list without pagination metadata. Each voice carries `id`, `name`, `provider`, `provider_voice_id`, `gender`, `accent`, `icon`, `recording`, `languages` (each with a `lang_` `id`, `name` and `code`) and `llms` (each with an `llm_` `id`, `name`, `provider` and `provider_id`).

## Related endpoints

* [Speech To Speech Agents](https://dialnexa.com/docs/agents/speech-to-speech-agents.md): configure realtime agents.
* [List Voices](https://dialnexa.com/docs/api-reference/v1/voices/list.md): list cascaded TTS voices.
* [List Voice Languages](https://dialnexa.com/docs/api-reference/v1/voices/languages.md): inspect language choices for one voice.


## OpenAPI

````yaml GET /v1/voices/s2s
openapi: 3.0.0
info:
  title: DialNexa API
  description: Public `/v1` REST API for the DialNexa voice AI platform.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: Agents
  - name: Batch Calls
  - name: Calls
  - name: Knowledge Base
  - name: Languages
  - name: LLMs
  - name: Phone Numbers
  - name: Organization Folders
  - name: Transcribers
  - name: Webhooks
  - name: Voices
  - name: Workflows
  - name: Workflow Leads
  - name: Authentication
  - name: Agent Builder
  - name: Agent Evaluations
paths:
  /v1/voices/s2s:
    get:
      tags:
        - Voices
      summary: List Speech-to-Speech Voices
      description: >-
        Returns voices that support speech-to-speech mode, along with their
        compatible languages and LLMs.
      operationId: listSpeechToSpeechVoices
      parameters: []
      responses:
        '200':
          description: Speech to speech voices returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: voice_mj18r4tq2w9xkp
                    name:
                      type: string
                      example: Ash
                    provider:
                      type: string
                      example: openai
                      nullable: true
                    provider_voice_id:
                      type: string
                      example: ash
                      nullable: true
                    gender:
                      type: string
                      example: male
                    accent:
                      type: string
                      example: american
                      nullable: true
                    icon:
                      type: string
                      nullable: true
                    recording:
                      type: string
                      nullable: true
                    languages:
                      type: array
                      items:
                        $ref: '#/components/schemas/SpeechToSpeechLanguage'
                    llms:
                      type: array
                      items:
                        $ref: '#/components/schemas/SpeechToSpeechModel'
                  required:
                    - id
                    - name
                    - provider
                    - provider_voice_id
                    - gender
                    - accent
                    - icon
                    - recording
                    - languages
                    - llms
              examples:
                success:
                  summary: Successful response
                  value:
                    - id: voice_mj18r4tq2w9xkp
                      name: Ash
                      provider: openai
                      provider_voice_id: ash
                      gender: male
                      accent: american
                      icon: null
                      recording: >-
                        https://speechailogs.blob.core.windows.net/openai-voices/openai-ash-tts.mp3
                      languages:
                        - id: lang_mfgsys4f62f0vb
                          name: Hindi
                          code: hi
                        - id: lang_mfgsys4hhg8gdn
                          name: English
                          code: en
                      llms:
                        - id: llm_mj17v3n8k2q5wd
                          name: GPT-realtime-2
                          provider: openai
                          provider_id: gpt-realtime-2
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilteredErrorResponse'
              examples:
                error:
                  summary: 401 Unauthorized
                  value:
                    message: >-
                      API key is missing or invalid. You can generate this by
                      logging in into dashboard
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilteredErrorResponse'
              examples:
                error:
                  summary: 500 Internal Server Error
                  value:
                    message: An unexpected error occurred. Please try again later.
      security:
        - bearer: []
components:
  schemas:
    SpeechToSpeechLanguage:
      type: object
      properties:
        id:
          type: string
          example: lang_mfgsys4f62f0vb
        name:
          type: string
          example: Hindi
        code:
          type: string
          example: hi
      required:
        - id
        - name
        - code
    SpeechToSpeechModel:
      type: object
      properties:
        id:
          type: string
          example: llm_mj17v3n8k2q5wd
        name:
          type: string
          example: GPT-realtime-2
        provider:
          type: string
          example: openai
        provider_id:
          type: string
          example: gpt-realtime-2
      required:
        - id
        - name
        - provider
        - provider_id
    FilteredErrorResponse:
      type: object
      description: >-
        Error body on calls, batch calls, voices, languages and LLMs, which
        return only the message (and data for a coded refusal).
      properties:
        message:
          type: string
        data:
          type: object
          properties:
            code:
              type: string
              description: Machine-readable refusal code.
          description: >-
            Present for a coded refusal: code and the details listed for that
            code.
        validation_errors:
          type: array
          description: >-
            Present when uploaded rows fail number validation (batch and
            workflow lead uploads): one group per distinct error.
          items:
            type: object
            properties:
              error:
                type: string
              rows:
                type: array
                items:
                  type: integer
                description: Row numbers with this error.
              phone_numbers:
                type: array
                items:
                  type: string
        invalid_row_count:
          type: integer
          description: 'Present with validation_errors: how many rows failed.'
      required:
        - message
  securitySchemes:
    bearer:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.