Retrieve a transcription by its ID, including current status, transcript text (when completed), billing information, and links to related operations.
Retrieves a single transcription by ID. If the transcription is still in queued or processing status and the last status check was more than 10 seconds ago, the service automatically polls the upstream provider for the latest status. This means you can use this endpoint for polling without additional configuration.
Supports ETag caching via the If-None-Match header. When the transcription has not changed since the last request, the API returns 304 Not Modified with no body, saving bandwidth.
Cache behavior varies by status:
queued/processing:Cache-Control: public, max-age=5(short TTL for active polling)completed/failed:Cache-Control: public, max-age=86400(long TTL for stable results)
transcription_id string required
The transcription ID with trans_ prefix (e.g., trans_a1b2c3d4e5f6...).
if-none-match string optional
ETag value from a previous response. If the transcription has not changed, returns 304 Not Modified.
Returns a success envelope with:
data-- Transcription data includingtranscription_id,status,model_key,audio_metadata(url, duration, language), andtimestamps(created_at, updated_at, completed_at, processing_time_seconds).billing-- Billing details:synapses_consumed,synapses_refunded,currency.metadata-- Request metadata:request_id,timestamp,processing_time_ms,upstream_refreshed(whether a fresh status poll was made).actions-- HATEOAS links. When completed, includesget_paragraphs,get_sentences,get_subtitles_srt,get_subtitles_vtt,get_subtitles_txt,search, and optionallyredacted_audio(if PII redaction was enabled).
Response headers include ETag, Last-Modified, and Cache-Control.
- Bash
- Python
- Python
- JavaScript
curl -s -X GET https://api.aitronos.com/v1/audio/transcribe/trans_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "If-None-Match: \"abc123etag\"" | python3 -m json.tool