Get transcription transcript
Retrieves the full transcript text and detailed tokens for a completed transcription. Only available for successfully completed transcriptions.
Retrieves the full transcript text and detailed tokens for a completed transcription. Only available for successfully completed transcriptions.
Headers
AuthorizationRequiredBearer <SONIOX_API_KEY>Path parameters
transcription_idRequiredstringFormat:
"uuid"Response
200
Transcription transcript.
idRequiredstringUnique identifier of the transcription this transcript belongs to.
Format:
"uuid"textRequiredstringComplete transcribed text content.
tokensRequiredarray<object>List of detailed token information with timestamps and metadata.
Errors
Transcription transcript.
{
"id": "19b6d61d-02db-4c25-bc71-b4094dc310c8",
"text": "Hello",
"tokens": [
{
"text": "Hel",
"start_ms": 10,
"end_ms": 90,
"confidence": 0.95
},
{
"text": "lo",
"start_ms": 110,
"end_ms": 160,
"confidence": 0.98
}
]
}Authentication error.
{
"status_code": 401,
"error_type": "unauthenticated",
"message": "Incorrect API key provided. You can get an API key at https://console.soniox.com",
"validation_errors": [],
"request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda",
"more_info": "https://soniox.com/docs/api-reference/errors#unauthenticated"
}Transcription not found.
Error types:
transcription_not_found: No transcription with this ID exists in the project the API key is scoped to (it may have been deleted, the ID may be wrong, or it may belong to a different project).
{
"status_code": 404,
"error_type": "transcription_not_found",
"message": "No transcription with this ID exists in your project. It may have been deleted, the ID may be incorrect, or the transcription may belong to a different project. Verify the ID by listing transcriptions with GET /transcriptions.",
"validation_errors": [],
"request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda",
"more_info": "https://soniox.com/docs/api-reference/errors#transcription-not-found"
}Invalid transcription state.
The transcription exists but the transcript cannot be returned in its current state.
Error types:
transcription_invalid_state. Themessageindicates which sub-case applies:- Not completed yet — transcription is still queued, downloading, or transcribing. Poll
GET /transcriptions/{id}untilstatusiscompleted, or configure a webhook on the transcription. - Failed — transcription ended in
failedstate. Inspecterror_type/error_messageonGET /transcriptions/{id}for the failure reason.
- Not completed yet — transcription is still queued, downloading, or transcribing. Poll
{
"status_code": 409,
"error_type": "transcription_invalid_state",
"message": "The transcript is not ready yet — transcription is still in progress. Poll GET /transcriptions/{id} until `status` is `completed`, or configure a webhook when creating the transcription to be notified when it finishes.",
"validation_errors": [],
"request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda",
"more_info": "https://soniox.com/docs/api-reference/errors#transcription-invalid-state"
}Rate / capacity limit exceeded.
Error types:
limit_exceeded: The caller hit a per-minute request rate or other capacity limit. Themessagedescribes which limit was hit.
{
"status_code": 429,
"error_type": "limit_exceeded",
"message": "Requests per minute limit for async transcription has been exceeded for your organization.",
"validation_errors": [],
"request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda",
"more_info": "https://soniox.com/docs/api-reference/errors#limit-exceeded"
}Internal server error.
{
"status_code": 500,
"error_type": "internal_error",
"message": "The server encountered an error. Please try again. If the issue persists contact support@soniox.com.",
"validation_errors": [],
"request_id": "3d37a3bd-5078-47ee-a369-b204e3bbedda",
"more_info": "https://soniox.com/docs/api-reference/errors#internal-error"
}