List Transcriptions
Your personal Gladia API key
The starting point for pagination. A value of 0 starts from the first item.
The maximum number of items to return. Useful for pagination and controlling data payload size.
Filter the list based on item status. Accepts multiple values from the predefined list.
Filter the list based on the item type. Supports multiple values from the predefined list.
Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
Include items that occurred before the specified date in ISO format.
Filter for items after the specified date. Use with before_date
for a range. Date in ISO format.
curl --request GET \
--url https://api.gladia.io/v2/transcription \
--header 'x-gladia-key: <api-key>'
{
"items": [
{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-45463597",
"kind": [
"pre-recorded"
],
"created_at": "2023-12-28T09:04:17.210Z",
"custom_metadata": {},
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"context_prompt": "<string>",
"custom_vocabulary": [
"<string>"
],
"detect_language": true,
"enable_code_switching": true,
"language": "en",
"callback_url": "http://callback.example",
"subtitles": true,
"subtitles_config": {
"formats": [
"srt"
]
},
"diarization": true,
"diarization_config": {
"number_of_speakers": 2,
"min_speakers": 1,
"max_speakers": 2
},
"translation": true,
"translation_config": {
"target_languages": [
"en"
],
"model": "base"
},
"summarization": true,
"summarization_config": {
"type": "general"
},
"moderation": true,
"audio_to_llm": true,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
]
},
"sentences": true,
"audio_url": "<string>"
},
"status": "queued"
}
],
"first": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
"current": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
"next": "https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20"
}
Authorizations
Your personal Gladia API key
Query Parameters
The starting point for pagination. A value of 0 starts from the first item.
The maximum number of items to return. Useful for pagination and controlling data payload size.
Filter the list based on item status. Accepts multiple values from the predefined list.
queued
, processing
, done
, error
Filter the list based on the item type. Supports multiple values from the predefined list.
pre-recorded
, live
Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
Include items that occurred before the specified date in ISO format.
Filter for items after the specified date. Use with before_date
for a range. Date in ISO format.
Response
List of retrieved transcription for this range
Id of the transcription
Debug id
Transcription kind. "pre-recorded" for transcription on pre-recorded file. "live" for transcription using the live streaming websocket.
pre-recorded
, live
Creation date
Custom metadata given in the transcription request
The file data you uploaded
The file id
The name of the uploaded file
The link used to download the file if audio_url was used
Duration of the audio file
Number of channels in the audio file
Parameters used for this transcription.
Context to feed the transcription model with for possible better performance
Specific vocabulary list to feed the transcription model with
Detect the language from the given audio
Detect multiple languages in the given audio
Set the spoken language for the given audio
af
, sq
, am
, ar
, hy
, as
, az
, ba
, eu
, be
, bn
, bs
, br
, bg
, ca
, zh
, hr
, cs
, da
, nl
, en
, at
, fo
, fi
, fr
, gl
, ka
, de
, el
, gu
, ht
, ha
, haw
, he
, hi
, hu
, is
, id
, it
, jp
, jv
, kn
, kk
, km
, ko
, lo
, la
, lv
, ln
, lt
, lb
, mk
, mg
, ms
, ml
, mt
, mi
, mr
, mn
, mymr
, ne
, no
, nn
, oc
, ps
, fa
, pl
, pt
, pa
, ro
, ru
, sa
, sr
, sn
, sd
, si
, sk
, sl
, so
, es
, su
, sw
, sv
, tl
, tg
, ta
, tt
, te
, th
, bo
, tr
, tk
, uk
, ur
, uz
, vi
, cy
, yi
, yo
Callback URL we will do a POST
request to with the result of the transcription
Enable subtitles generation for this transcription
Configuration for subtitles generation if subtitles
is enabled
Subtitles formats you want your transcription to be formatted to
srt
, vtt
Enable speaker recognition (diarization) for this audio
Speaker recognition configuration, if diarization
is enabled
Exact number of speakers in the audio
Minimum number of speakers in the audio
Maximum number of speakers in the audio
Enable translation for this audio
Translation configuration, if translation
is enabled
Target language in iso639-1
format you want the transcription translated to
af
, sq
, am
, ar
, hy
, as
, ast
, az
, ba
, eu
, be
, bn
, bs
, br
, bg
, my
, ca
, ceb
, zh
, hr
, cs
, da
, nl
, en
, at
, fo
, fi
, nl
, fr
, fy
, ff
, gd
, gl
, lg
, ka
, de
, el
, gu
, ht
, ha
, haw
, he
, hi
, hu
, is
, ig
, ilo
, id
, ga
, it
, jp
, jv
, kn
, kk
, km
, ko
, lo
, la
, lv
, ln
, lt
, lb
, mk
, mg
, ms
, ml
, mt
, mi
, mr
, mo
, mn
, mymr
, ne
, no
, nn
, oc
, or
, pa
, ps
, fa
, pl
, pt
, pa
, ro
, ru
, sa
, sr
, sn
, sd
, si
, sk
, sl
, so
, es
, su
, sw
, ss
, sv
, tl
, tg
, ta
, tt
, te
, th
, bo
, tn
, tr
, tk
, uk
, ur
, uz
, vi
, cy
, wo
, xh
, yi
, yo
, zu
Model you want the translation model to use to translate
base
, enhanced
Enable summarization for this audio
Summarization configuration, if summarization
is enabled
The type of summarization to apply
general
, bullet_points
, concise
Enable moderation for this audio
Enable audio to llm processing for this audio
Audio to llm configuration, if audio_to_llm
is enabled
The list of prompts applied on the audio transcription
Enable sentences for this audio
Transcription is on the queue, waiting to be processed
queued
URL to fetch the first page
URL to fetch the current page
URL to fetch the next page
Was this page helpful?
curl --request GET \
--url https://api.gladia.io/v2/transcription \
--header 'x-gladia-key: <api-key>'
{
"items": [
{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-45463597",
"kind": [
"pre-recorded"
],
"created_at": "2023-12-28T09:04:17.210Z",
"custom_metadata": {},
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"context_prompt": "<string>",
"custom_vocabulary": [
"<string>"
],
"detect_language": true,
"enable_code_switching": true,
"language": "en",
"callback_url": "http://callback.example",
"subtitles": true,
"subtitles_config": {
"formats": [
"srt"
]
},
"diarization": true,
"diarization_config": {
"number_of_speakers": 2,
"min_speakers": 1,
"max_speakers": 2
},
"translation": true,
"translation_config": {
"target_languages": [
"en"
],
"model": "base"
},
"summarization": true,
"summarization_config": {
"type": "general"
},
"moderation": true,
"audio_to_llm": true,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
]
},
"sentences": true,
"audio_url": "<string>"
},
"status": "queued"
}
],
"first": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
"current": "https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20",
"next": "https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20"
}