--- title: "Get Transcript By Id" method: GET path: "/v1/speech-to-text/transcripts/{transcription_id}" tags: ["speech-to-text"] --- # Get Transcript By Id `GET /v1/speech-to-text/transcripts/{transcription_id}` Retrieve a previously generated transcript by its ID. ## Path parameters - `transcription_id` string, required — The unique ID of the transcript to retrieve ## Headers - `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website. ## Response `200` The transcript data - union - union — Chunk-level detail of the transcription with timing information. - object — Chunk-level detail of the transcription with timing information. - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer - `additional_formats` AdditionalFormatResponseModel[] - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `transcription_id` string - `entities` DetectedEntity[] - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `audio_duration_secs` number - `edited_transcript` union - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - object — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `text` string, required — The edited transcript text. - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - object — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - object — Response model for multichannel speech-to-text transcription. - `transcripts` SpeechToTextChunkResponseModel[], required — List of transcripts, one for each audio channel. Each transcript contains the text and word-level details for its respective channel. - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer, nullable — The channel index this transcript belongs to (for multichannel audio). - `additional_formats` AdditionalFormatResponseModel[], nullable — Requested additional formats of the transcript. - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `transcription_id` string, nullable — The transcription ID of the response. - `entities` DetectedEntity[], nullable — List of detected entities with their text, type, and character positions in the transcript. - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `audio_duration_secs` number, nullable — The duration of the audio that was transcribed in seconds. - `edited_transcript` union — Result of the optional transcript edit: the edited text, or an error if it could not be produced. Absent when no edit was requested. - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - `transcription_id` string - `audio_duration_secs` number - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer, nullable — The channel index this transcript belongs to (for multichannel audio). - `additional_formats` AdditionalFormatResponseModel[], nullable — Requested additional formats of the transcript. - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `entities` DetectedEntity[], nullable — List of detected entities with their text, type, and character positions in the transcript. - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `edited_transcript` union — Result of the optional transcript edit: the edited text, or an error if it could not be produced. Absent when no edit was requested. - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - union — Response model for multichannel speech-to-text transcription. - object — Chunk-level detail of the transcription with timing information. - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer, nullable — The channel index this transcript belongs to (for multichannel audio). - `additional_formats` AdditionalFormatResponseModel[], nullable — Requested additional formats of the transcript. - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `transcription_id` string - `entities` DetectedEntity[], nullable — List of detected entities with their text, type, and character positions in the transcript. - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `audio_duration_secs` number - `edited_transcript` union — Result of the optional transcript edit: the edited text, or an error if it could not be produced. Absent when no edit was requested. - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - `transcripts` SpeechToTextChunkResponseModel[], required — List of transcripts, one for each audio channel. Each transcript contains the text and word-level details for its respective channel. - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer, nullable — The channel index this transcript belongs to (for multichannel audio). - `additional_formats` AdditionalFormatResponseModel[], nullable — Requested additional formats of the transcript. - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `transcription_id` string, nullable — The transcription ID of the response. - `entities` DetectedEntity[], nullable — List of detected entities with their text, type, and character positions in the transcript. - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `audio_duration_secs` number, nullable — The duration of the audio that was transcribed in seconds. - `edited_transcript` union — Result of the optional transcript edit: the edited text, or an error if it could not be produced. Absent when no edit was requested. - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - object — Response model for multichannel speech-to-text transcription. - `transcripts` SpeechToTextChunkResponseModel[], required — List of transcripts, one for each audio channel. Each transcript contains the text and word-level details for its respective channel. - `language_code` string, required — The detected language code (e.g. 'eng' for English). - `language_probability` number, required — The confidence score of the language detection (0 to 1). - `text` string, required — The raw text of the transcription. - `words` SpeechToTextWordResponseModel[], required — List of words with their timing information. - `text` string, required — The word or sound that was transcribed. - `start` number, nullable — The start time of the word or sound in seconds. - `end` number, nullable — The end time of the word or sound in seconds. - `type` 'word' | 'spacing' | 'audio_event', required — The type of the word or sound. 'audio_event' is used for non-word sounds like laughter or footsteps. - `speaker_id` string, nullable — Unique identifier for the speaker of this word. - `logprob` number, required — The log of the probability with which this word was predicted. Logprobs are in range [-infinity, 0], higher logprobs indicate a higher confidence the model has in its predictions. - `characters` SpeechToTextCharacterResponseModel[], nullable — The characters that make up the word and their timing information. - `text` string, required — The character that was transcribed. - `start` number, nullable — The start time of the character in seconds. - `end` number, nullable — The end time of the character in seconds. - `channel_index` integer, nullable — The channel this word was spoken on (for multichannel audio). Null for single-channel transcriptions. - `channel_index` integer, nullable — The channel index this transcript belongs to (for multichannel audio). - `additional_formats` AdditionalFormatResponseModel[], nullable — Requested additional formats of the transcript. - `requested_format` string, required — The requested format. - `file_extension` string, required — The file extension of the additional format. - `content_type` string, required — The content type of the additional format. - `is_base64_encoded` boolean, required — Whether the content is base64 encoded. - `content` string, required — The content of the additional format. - `transcription_id` string, nullable — The transcription ID of the response. - `entities` DetectedEntity[], nullable — List of detected entities with their text, type, and character positions in the transcript. - `text` string, required — The text that was identified as an entity. - `entity_type` string, required — The type of entity detected (e.g., 'credit_card', 'email_address', 'person_name'). - `start_char` integer, required — Start character position in the transcript text. - `end_char` integer, required — End character position in the transcript text. - `audio_duration_secs` number, nullable — The duration of the audio that was transcribed in seconds. - `edited_transcript` union — Result of the optional transcript edit: the edited text, or an error if it could not be produced. Absent when no edit was requested. - EditedTranscript — A transcript produced by the optional transcript edit (text only, untimed). - `kind` 'transcript', required - `text` string, required — The edited transcript text. - TranscriptEditError — An error returned in place of an edited transcript when the edit could not be produced. - `kind` 'error', required - `error_type` 'edit_failed', required — edit_failed: the edit could not be produced. - `message` string, required — A short, user-facing explanation of the failure. - `transcription_id` string - `audio_duration_secs` number ## Other responses - `401` — Authentication required - `404` — Transcript not found - `422` — Validation Error ## Changes - **2026-09-26** `48a38e3b0dbd` — 4 info - added the optional property `anyOf[subschema #1: SpeechToTextChunkResponseModel]/edited_transcript` to the response with the `200` status - added the optional property `anyOf[subschema #2: MultichannelSpeechToTextResponseModel]/transcripts/items/edited_transcript` to the response with the `200` status - added the optional property `oneOf[subschema #1: SpeechToTextChunkResponseModel]/edited_transcript` to the response with the `200` status - added the optional property `oneOf[subschema #2: MultichannelSpeechToTextResponseModel]/transcripts/items/edited_transcript` to the response with the `200` status [Change history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/speech-to-text/transcripts/:transcription_id/get.md) --- [API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/48a38e3b0dbd?raw)