> ## 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.

# Get Transcriber Details

> Fetch one transcriber catalog entry by ID.

<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 full record for a single speech-to-text transcriber supported by DialNexa. The response includes the transcriber's stable `id`, the upstream `provider` (such as Deepgram, AssemblyAI, or Whisper), the human-readable `name`, the primary `language_code`, and any configuration metadata the transcriber exposes.

## When to use this

Use this endpoint when you have a transcriber ID stored on an agent or in your own database and you need to confirm the engine is still supported, look up its display name, or check the languages it can handle.

* **Agent build UIs** call this to render the currently selected transcriber on a saved agent with its proper provider and capability badges.
* **Latency-tuning tooling** uses the response to decide between low-latency streaming transcribers and higher-accuracy batch transcribers.
* **Internationalization checks** confirm the transcriber supports the language assigned to the agent before publishing changes through [Update Agent](/docs/api-reference/v1/agents/update).

Use [List Transcribers](/docs/api-reference/v1/transcribers/list) if you need every available engine rather than a single record. Use [List Fallback Transcribers](/docs/api-reference/v1/transcribers/fallback) when you specifically need fallback STT options.

## Path parameters

| Parameter | Description                                   |
| --------- | --------------------------------------------- |
| `id`      | The transcriber ID, for example `trs_abc123`. |

## Errors

* `404 Not Found` is returned when the `id` does not match a supported transcriber. This usually indicates the engine was removed or the ID was mistyped.
* `401 Unauthorized` is returned when the API key is missing, malformed, or revoked.

## Related endpoints

* [List Transcribers](/docs/api-reference/v1/transcribers/list): fetch every transcriber the platform supports.
* [List Fallback Transcribers](/docs/api-reference/v1/transcribers/fallback): fetch fallback-eligible transcribers.
* [Update Agent](/docs/api-reference/v1/agents/update): change the transcriber assigned to an existing agent.
* [Speech-to-text and transcription](/docs/voice-ai/speech-to-text-and-transcription): guidance on choosing the right transcriber.


## OpenAPI

````yaml GET /v1/transcribers/{id}
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/{id}:
    get:
      tags:
        - Transcribers
        - Transcribers V1
        - V1
      summary: Get Transcriber Details
      description: Returns one speech-to-text transcriber catalog record by ID.
      operationId: TranscribersV1Controller_findById
      parameters:
        - name: id
          required: true
          in: path
          description: Transcriber ID
          schema:
            example: trs_abc123
            type: string
      responses:
        '200':
          description: Transcriber returned successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Transcriber'
              examples:
                success:
                  summary: Successful response
                  value:
                    id: trs_deepgram_nova_2
                    name: Deepgram Nova 2
                    provider: deepgram
                    supports_fallback: true
        '400':
          description: Invalid catalog ID format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 400 Bad Request
                  value:
                    statusCode: 400
                    message: Invalid catalog ID format
                    error: Bad Request
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 401 Unauthorized
                  value:
                    statusCode: 401
                    message: API key is missing or invalid
                    error: Unauthorized
        '403':
          description: Forbidden - API key does not have access to this organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 403 Forbidden
                  value:
                    statusCode: 403
                    message: You do not have permission to access this resource
                    error: Forbidden
        '404':
          description: Transcriber not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 404 Not Found
                  value:
                    statusCode: 404
                    message: Transcriber not found
                    error: Not Found
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  summary: 500 Internal Server Error
                  value:
                    statusCode: 500
                    message: Internal server error
                    error: Internal Server Error
      security:
        - bearer: []
components:
  schemas:
    Transcriber:
      type: object
      properties:
        id:
          type: string
          example: trs_abc123
          description: Signed transcriber ID
      required:
        - id
    ErrorResponse:
      type: object
      properties:
        statusCode:
          type: integer
          example: 400
        message:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
          example: phone_number must be a valid E.164 phone number
        error:
          type: string
          example: Bad Request
      required:
        - statusCode
        - message
        - error
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````