List Transcribers

GET

transcribers

List Transcribers

curl --request GET \
  --url https://api.dialnexa.com/v1/transcribers \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialnexa.com/v1/transcribers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/transcribers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/transcribers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/transcribers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": false,
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "id": "trs_tr0soniox001xx",
      "provider": "soniox",
      "model_id": "stt-rt-v5",
      "name": "Soniox STT RT v5",
      "description": "Soniox real-time speech-to-text model v5.",
      "supported_language_codes": null,
      "provider_model_id": "pmd_798b2e5834",
      "is_primary": true,
      "is_fallback": true,
      "is_deleted": false,
      "createdAt": "2026-03-01T00:00:00.000Z",
      "updatedAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "timestamp": "2026-09-07T06:00:00.000Z"
}

{
  "statusCode": 401,
  "error": true,
  "success": false,
  "data": [],
  "message": "Invalid API key",
  "errors": []
}

{
  "statusCode": 500,
  "error": true,
  "success": false,
  "data": [],
  "message": "Internal server error",
  "errors": []
}

Read only Returns every speech-to-text transcriber that can be an agent’s primary transcriber. Each entry includes the transcriber’s stable id, the upstream provider (for example deepgram, sarvam, soniox), the provider’s model_id, the display name, a description, the supported_language_codes it is limited to (null when it is not limited), and the is_primary and is_fallback flags. Use this endpoint as the source of truth when configuring an agent’s transcription settings, the transcriber you choose determines how accurately the agent understands what the caller says, which is especially important for accented speech, technical terminology, and non-English languages.

When to use this

Agent build UIs: populate the transcriber selector when creating or editing an agent.
Language coverage checks: confirm the transcriber supports every language an agent is configured for; publishing checks this too.
Cost optimization: switch high-volume use cases to lower-cost engines when accuracy budget allows.

For a single record, use Get Transcriber Details. For fallback STT choices, use List Fallback Transcribers.

Providers

The catalog is maintained by DialNexa and evolves over time; use the live response of this endpoint as the source of truth for which providers and models are offered.

Fallback Transcription

DialNexa exposes List Fallback Transcribers for fallback STT choices. To enable fallback STT on an agent, pass fallback_stt_enabled: true, stt_fallback_transcriber_id, and optionally stt_fallback_wait_ms to Create Agent or Update Agent.

Errors

401 Unauthorized is returned when the API key is missing or revoked.

Get Transcriber Details: fetch a single transcriber.
List Fallback Transcribers: fetch fallback-eligible transcribers.
Update Agent: change the transcriber assigned to an existing agent.
Speech-to-text and transcription: guidance on choosing the right engine.
Precise transcripts: get the most accurate post-call transcript.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Transcribers returned successfully.

success

enum<boolean>

required

Available options:

true

error

enum<boolean>

required

Available options:

false

statusCode

integer

required

Example:

200

message

string

required

Example:

"Success"

data

object[]

required

Show child attributes

timestamp

string<date-time>

required

List Transcribers

curl --request GET \
  --url https://api.dialnexa.com/v1/transcribers \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dialnexa.com/v1/transcribers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dialnexa.com/v1/transcribers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dialnexa.com/v1/transcribers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dialnexa.com/v1/transcribers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "error": false,
  "statusCode": 200,
  "message": "Success",
  "data": [
    {
      "id": "trs_tr0soniox001xx",
      "provider": "soniox",
      "model_id": "stt-rt-v5",
      "name": "Soniox STT RT v5",
      "description": "Soniox real-time speech-to-text model v5.",
      "supported_language_codes": null,
      "provider_model_id": "pmd_798b2e5834",
      "is_primary": true,
      "is_fallback": true,
      "is_deleted": false,
      "createdAt": "2026-03-01T00:00:00.000Z",
      "updatedAt": "2026-03-01T00:00:00.000Z"
    }
  ],
  "timestamp": "2026-09-07T06:00:00.000Z"
}

{
  "statusCode": 401,
  "error": true,
  "success": false,
  "data": [],
  "message": "Invalid API key",
  "errors": []
}

{
  "statusCode": 500,
  "error": true,
  "success": false,
  "data": [],
  "message": "Internal server error",
  "errors": []
}

Overview

Endpoints

When to use this

Providers

Fallback Transcription

Errors

Authorizations

Response

​When to use this

​Providers

​Fallback Transcription

​Errors

​Related endpoints

Authorizations

Response

When to use this

Providers

Fallback Transcription

Errors

Related endpoints