---
title: "Send to speech recognition"
method: POST
path: "/{sub_domain}/api/speech-recognition"
tags: ["Speech-Recognition"]
---

# Send to speech recognition

`POST /{sub_domain}/api/speech-recognition`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/speech-recognition`
- Auth: API key in header `Authorization`

Send existing call recordings to speech recognition for transcription.

**When to use.** Transcribe calls that were recorded earlier but not yet processed. To retrieve a finished transcription for a single call, use `GET /speech-recognition/{call_id}`. To search transcribed calls and have results delivered to your own endpoint, use `GET /speech-recognition` with a callback URL.

**Request body.** Provide exactly one of `call_ids`, `campaign_lead_ids` or `lead_ids` (each an array) to select the calls, plus:

- `token` (string, required): your speech recognition token. To obtain a token, contact your account manager.
- `languages` (array, required): up to three language codes to transcribe.
- `recording_side` (string, required): which channel to transcribe. One of `lead`, `agent`, `both`.
- `min_duration` (integer): minimum recording length in seconds. Default 1.
- `from`, `till` (date-time): restrict to calls created within this range.

**Returns.** A nested `results` tree keyed by the selector you sent (`calls`, `campaign_leads` or `leads`). Each call entry reports whether it was accepted for transcription, or the reason it was skipped (for example the recording is still being prepared, or the call was already sent).

**Note.** Only the token used to submit a call can later retrieve that call's transcription.

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Request body

- SpeechRecognitionInput
  - `call_ids` integer[], nullable: Array of call IDs (required unless campaign_lead_ids or lead_ids is set).
  - `campaign_lead_ids` integer[], nullable: Array of campaign lead IDs (required unless call_ids or lead_ids is set).
  - `lead_ids` integer[], nullable: Array of lead IDs (required unless call_ids or campaign_lead_ids is set).
  - `token` string, required: Speech recognition token. To obtain a token, contact your account manager.
  - `languages` string[], required: Speech recognition languages, up to 3.
  - `recording_side` string, required: Recording channels to transcribe. One of lead, agent, both.
  - `min_duration` integer, nullable: Minimum recording duration in seconds. Default 1.
  - `from` string, nullable: Minimum call creation date.
  - `till` string, nullable: Maximum call creation date.

## Response `201`

Successful Response

- SpeechRecognitionResponse
  - `results` object, required: Nested result tree. The shape depends on the filter used in the request; each leaf call entry is a SpeechResult object.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)