Get Transcriber Details

GET

transcribers

{id}

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

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

fetch('https://api.dialnexa.com/v1/transcribers/{id}', 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/{id}",
  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/{id}"

	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/{id}")

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": 404,
  "error": true,
  "success": false,
  "data": [],
  "message": "Transcriber tr0deepnova3xx not found",
  "errors": []
}

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

Read only 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, sarvam or soniox), the provider’s model_id, the human-readable 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 that say where it can be used.

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.
Compatibility tooling reads supported_language_codes to check a transcriber against the languages an agent speaks.
Internationalization checks confirm the transcriber supports the language assigned to the agent before publishing changes through Update Agent.

Use List Transcribers for the transcribers that can be an agent’s primary transcriber. Use List Fallback Transcribers when you specifically need fallback STT options.

Path parameters

Parameter	Description
`id`	The transcriber ID, for example `trs_tr0soniox001xx`.

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.

List Transcribers: fetch the transcribers that can be an agent’s primary 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 transcriber.

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Transcriber ID

Example:

"trs_tr0soniox001xx"

Response

Transcriber 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

Get Transcriber Details

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

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

fetch('https://api.dialnexa.com/v1/transcribers/{id}', 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/{id}",
  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/{id}"

	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/{id}")

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": 404,
  "error": true,
  "success": false,
  "data": [],
  "message": "Transcriber tr0deepnova3xx not found",
  "errors": []
}

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

Overview

Endpoints

When to use this

Path parameters

Errors

Authorizations

Path Parameters

Response

​When to use this

​Path parameters

​Errors

​Related endpoints

Authorizations

Path Parameters

Response

When to use this

Path parameters

Errors

Related endpoints