> ## 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 Fallback Transcribers

> List transcribers that can be used as fallback STT providers.

<span data-api-safety-label="read-only"><Badge color="gray" size="sm" shape="pill">Read only</Badge></span>

<Info>
  **Recommended.** This endpoint is part of the public `/v1` API reference and is the supported path for new integrations. See the [migration guide](/docs/api-reference/v1/migrating-to-v1) for versioning guidance.
</Info>

Returns the transcribers that DialNexa can use as fallback speech-to-text providers. Use this endpoint when you are building an agent configuration UI or validating an agent payload before setting `stt_fallback_transcriber_id`.

## When to use this

* **Agent configuration UIs**: populate the Fallback STT selector with eligible transcribers.
* **Validation scripts**: confirm a saved fallback transcriber ID still exists before updating an agent.
* **Runtime configuration tools**: separate primary transcriber choices from fallback-specific choices when your UI exposes both.

For the full transcriber catalog, use [List Transcribers](/docs/api-reference/v1/transcribers/list).

## Example request

```bash theme={null}
curl "https://api.dialnexa.com/v1/transcribers/fallback" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example response

```json theme={null}
[
  {
    "id": "trs_tr0deepnova3xx",
    "name": "Deepgram Nova 2",
    "provider": "deepgram",
    "model_id": "nova-2",
    "description": null,
    "supported_language_codes": null
  }
]
```

`supported_language_codes: null` means the fallback transcriber is not limited to a fixed language-code list in the catalog response.

## Use the ID on an agent

After you choose a fallback transcriber, pass its `id` to [Create Agent](/docs/api-reference/v1/agents/create) or [Update Agent](/docs/api-reference/v1/agents/update):

```json theme={null}
{
  "fallback_stt_enabled": true,
  "stt_fallback_transcriber_id": "trs_tr0deepnova3xx",
  "stt_fallback_wait_ms": 1200
}
```

## Errors

* `401 Unauthorized` is returned when the API key is missing, malformed, or revoked.
* `403 Forbidden` is returned when the API key cannot access the organization.

## Related endpoints

* [List Transcribers](/docs/api-reference/v1/transcribers/list): fetch the full speech-to-text catalog.
* [Get Transcriber Details](/docs/api-reference/v1/transcribers/get): inspect one transcriber by ID.
* [Create Agent](/docs/api-reference/v1/agents/create): configure fallback STT while creating an agent.
* [Update Agent](/docs/api-reference/v1/agents/update): change fallback STT on an existing agent.


## OpenAPI

````yaml GET /v1/transcribers/fallback
openapi: 3.0.0
info:
  title: DialNexa API
  description: >-
    Public REST API for the DialNexa voice AI platform. Versioned endpoints are
    under /v1; unversioned endpoints are legacy and deprecated.
  version: 1.0.0
servers:
  - url: https://api.dialnexa.com
    description: DialNexa production API
security:
  - bearer: []
tags:
  - name: API Keys
  - name: Agent Functions
  - name: Agents V1
  - name: Agents2
  - name: Batch Calls
  - name: Batch Calls V1
  - name: Call Logs
  - name: Calls
  - name: Calls V1
  - name: Campaign Leads
  - name: Campaigns
  - name: External Webhooks
  - name: Knowledge Base
  - name: Knowledge Base V1
  - name: LLMs
  - name: LLMs V1
  - name: Languages
  - name: Languages V1
  - name: Organization Phone Numbers
  - name: Organization Phone Numbers V1
  - name: Phone Number Pricing
  - name: Phone Number Pricing V1
  - name: Transcribers
  - name: Transcribers V1
  - name: User Webhooks
  - name: User Webhooks V1
  - name: V1
  - name: Voices
  - name: Voices V1
  - name: Webcall
  - name: Workflow Leads
  - name: Workflow Leads V1
  - name: Workflows
  - name: Workflows V1
paths:
  /v1/transcribers/fallback:
    get:
      tags:
        - Transcribers
        - Transcribers V1
        - V1
      summary: List Fallback Transcribers
      description: >-
        Returns all transcribers eligible for use as a fallback STT provider.
        Use this list to populate the Fallback STT selector when configuring
        per-agent STT fallback settings.
      operationId: TranscribersV1Controller_findFallbacks
      parameters: []
      responses:
        '200':
          description: Fallback-eligible transcribers returned successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      example: trs_tr0deepnova3xx
                    name:
                      type: string
                      example: Deepgram Nova 2
                    provider:
                      type: string
                      example: deepgram
                    model_id:
                      type: string
                      example: nova-2
                    description:
                      type: string
                      nullable: true
                    supported_language_codes:
                      type: array
                      items:
                        type: string
                      nullable: true
                      example: null
                      description: null means all languages supported
        '401':
          description: Unauthorized - missing or invalid API key.
        '403':
          description: Forbidden - API key does not have access to this organization.
        '500':
          description: Internal server error.
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````