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.

Open in ClaudeOpen in ChatGPT
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

NameInRequiredDescription
transcriptionIdpathYes

Example request

curl -X GET https://aishorty.com/v1/v1/transcriptions/{transcriptionId} \
  -H "Authorization: Bearer shk_live_your_key"

Response · 200

FieldTypeRequiredDescription
idstringYesStable transcription id.
statusstringYesProcessing status: PENDING, PROCESSING, SUCCESS, or ERROR.
progressnumberYesCompletion fraction 0–100.
model_typestringYesWhisper model used (e.g. WHISPER_BASE, WHISPER_LARGE_V3).
languagestring or nullYesRequested/detected language, or null for auto-detect.
input_filestringYesThe source media URL that was transcribed.
errorstring or nullYesError message if the job failed, else null.
created_atstringYesISO-8601 UTC timestamp the transcription was created.
output_textstring or nullYesThe transcript text, or null if not yet produced.

Errors

On failure this endpoint returns an RFC 9457 problem body. Possible statuses:

  • 400
  • 401
  • 403
  • 404
  • 429
  • 500

Switch on the problem code, not the status. See the error reference for every code and how to fix it.