---
title: "Start transcription"
method: POST
path: "/calls/1/calls/{callId}/start-transcription"
tags: ["channels", "voice", "calls", "call-legs", "calls-operations"]
---

# Start transcription

`POST /calls/1/calls/{callId}/start-transcription`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/calls/1/calls/{callId}/start-transcription`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Start call transcription.

## Path parameters

- `callId` string, required

## Request body

- 08fdb52de63aac13de3ed81c2cf06532bc7e9a861dae97f83fafd7a6d53a779ePublicStartTranscriptionRequest
  - `transcription` 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611Transcription
    - `language` 'af-ZA' | 'sq-AL' | 'am-ET' | 'ar-KW' | 'ar-AE' | 'ar-BH' | 'ar-DZ' | 'ar-EG' | 'ar-IL' | 'ar-IQ' | 'ar-JO' | 'ar-LB' | 'ar-LY' | 'ar-MA' | 'ar-OM' | 'ar-PS' | 'ar-QA' | 'ar-SA' | 'ar-SY' | 'ar-TN' | 'ar-YE' | 'hy-AM' | 'az-AZ' | 'eu-ES' | 'bn-IN' | 'bn-BD' | 'bs-BA' | 'bg-BG' | 'my-MM' | 'ca-ES' | 'zh-CN' | 'zh-HK' | 'zh-TW' | 'hr-HR' | 'cs-CZ' | 'da-DK' | 'nl-NL' | 'nl-BE' | 'en-AU' | 'en-CA' | 'en-GB' | 'en-GH' | 'en-HK' | 'en-IE' | 'en-IN' | 'en-KE' | 'en-NG' | 'en-NZ' | 'en-PH' | 'en-PK' | 'en-SG' | 'en-TZ' | 'en-US' | 'en-ZA' | 'et-EE' | 'fil-PH' | 'fi-FI' | 'fr-BE' | 'fr-CA' | 'fr-CH' | 'fr-FR' | 'gl-ES' | 'ka-GE' | 'de-AT' | 'de-CH' | 'de-DE' | 'el-GR' | 'gu-IN' | 'he-IL' | 'hi-IN' | 'hu-HU' | 'is-IS' | 'id-ID' | 'ga-IE' | 'it-CH' | 'it-IT' | 'ja-JP' | 'jv-ID' | 'kn-IN' | 'kk-KZ' | 'km-KH' | 'ko-KR' | 'lo-LA' | 'lv-LV' | 'lt-LT' | 'mk-MK' | 'ms-MY' | 'ml-IN' | 'mt-MT' | 'mr-IN' | 'mn-MN' | 'ne-NP' | 'no-NO' | 'fa-IR' | 'pl-PL' | 'pt-PT' | 'pt-BR' | 'pa-Guru-IN' | 'ro-RO' | 'ru-RU' | 'sr-RS' | 'si-LK' | 'sk-SK' | 'sl-SI' | 'es-BO' | 'es-AR' | 'es-CL' | 'es-CO' | 'es-CR' | 'es-CU' | 'es-DO' | 'es-EC' | 'es-ES' | 'es-GQ' | 'es-GT' | 'es-HN' | 'es-MX' | 'es-NI' | 'es-PA' | 'es-PE' | 'es-PR' | 'es-PY' | 'es-SV' | 'es-US' | 'es-UY' | 'es-VE' | 'su-ID' | 'sw-TZ' | 'sw-KE' | 'sv-SE' | 'ta-IN' | 'ta-LK' | 'ta-MY' | 'ta-SG' | 'te-IN' | 'th-TH' | 'tr-TR' | 'uk-UA' | 'ur-IN' | 'ur-PK' | 'uz-UZ' | 'vi-VN' | 'zu-ZA', required
    - `sendInterimResults` boolean: Flag indicating whether interim transcription results should be sent.
    - `customDictionary` string[]: Array of custom words used for more accurate transcription.
    - `advancedFormatting` boolean: Toggles enhanced text formatting features like punctuation, proper casing, numeral normalization, and disfluency filtering. Defaults to `false`.
    - `provider` 'GOOGLE' | 'AZURE' | 'DEEPGRAM': Speech-to-text provider to use. Defaults to `AZURE`.

## Response `200`

Success

- 4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611ActionResponse
  - `status` 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Action status.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)