GET /v1/transcriptions/{transcriptionId}
Get a transcription — Shorty API
Returns one transcription the authenticated account owns, including the transcript text. A non-existent or foreign id returns 404.
GET /v1/transcriptions/{transcriptionId}Returns one transcription the authenticated account owns, including the transcript text. A non-existent or foreign id returns 404.
Authentication
Requires a Bearer credential — a shk_live_ API key or an OAuth 2.1 access token with the scope for this resource. See Authentication.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
transcriptionId | path | Yes | — |
Example request
curl -X GET https://aishorty.com/v1/v1/transcriptions/{transcriptionId} \
-H "Authorization: Bearer shk_live_your_key"Response · 200
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Stable transcription id. |
status | string | Yes | Processing status: PENDING, PROCESSING, SUCCESS, or ERROR. |
progress | number | Yes | Completion fraction 0–100. |
model_type | string | Yes | Whisper model used (e.g. WHISPER_BASE, WHISPER_LARGE_V3). |
language | string or null | Yes | Requested/detected language, or null for auto-detect. |
input_file | string | Yes | The source media URL that was transcribed. |
error | string or null | Yes | Error message if the job failed, else null. |
created_at | string | Yes | ISO-8601 UTC timestamp the transcription was created. |
output_text | string or null | Yes | The transcript text, or null if not yet produced. |
Errors
On failure this endpoint returns an RFC 9457 problem body. Possible statuses:
400401403404429500
Switch on the problem code, not the status. See the error reference for every code and how to fix it.