API Documentation
Upload
Pre-recorded endpoints
Live endpoints
Live WS actions
Live WS messages
- Realtime messages
- Post-processing messages
- Acknowledgment messages
- Lifecycle messages
Live callbacks
- Realtime messages
- Post-processing messages
- Acknowledgment messages
- Lifecycle messages
Live webhooks
- Lifecycle messages
List transcriptions
List all the pre-recorded transcriptions matching the parameters.
curl --request GET \
--url https://api.gladia.io/v2/pre-recorded \
--header 'x-gladia-key: <api-key>'
{
"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",
"items": [
{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-45463597",
"version": 2,
"status": "queued",
"created_at": "2023-12-28T09:04:17.210Z",
"completed_at": "2023-12-28T09:04:37.210Z",
"custom_metadata": {},
"error_code": 500,
"kind": "pre-recorded",
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"context_prompt": "<string>",
"custom_vocabulary": false,
"custom_vocabulary_config": {
"vocabulary": [
"Westeros",
{
"value": "Stark"
},
{
"value": "Night's Watch",
"pronunciations": [
"Nightz Watch"
],
"intensity": 0.4,
"language": "en"
}
],
"default_intensity": 0.5
},
"detect_language": true,
"enable_code_switching": false,
"code_switching_config": {
"languages": []
},
"language": "en",
"callback_url": "http://callback.example",
"callback": false,
"callback_config": {
"url": "http://callback.example",
"method": "POST"
},
"subtitles": false,
"subtitles_config": {
"formats": [
"srt"
],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": false,
"diarization_config": {
"number_of_speakers": 2,
"min_speakers": 1,
"max_speakers": 2,
"enhanced": false
},
"translation": false,
"translation_config": {
"target_languages": [
"en"
],
"model": "base",
"match_original_utterances": true,
"lipsync": true
},
"summarization": false,
"summarization_config": {
"type": "general"
},
"moderation": false,
"named_entity_recognition": false,
"chapterization": false,
"name_consistency": false,
"custom_spelling": false,
"custom_spelling_config": {
"spelling_dictionary": {
"Gettleman": [
"gettleman"
],
"SQL": [
"Sequel"
]
}
},
"structured_data_extraction": false,
"structured_data_extraction_config": {
"classes": [
"Persons",
"Organizations"
]
},
"sentiment_analysis": false,
"audio_to_llm": false,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
]
},
"sentences": false,
"display_mode": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
},
"audio_url": "<string>"
},
"result": {
"metadata": {
"audio_duration": 3600,
"number_of_distinct_channels": 1,
"billing_time": 3600,
"transcription_time": 20
},
"transcription": {
"full_transcript": "<string>",
"languages": [
"en"
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<string>"
}
],
"utterances": [
{
"language": "en",
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"speaker": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>"
}
]
},
"translation": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"full_transcript": "<string>",
"languages": [
"en"
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<string>"
}
],
"utterances": [
{
"language": "en",
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"speaker": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>"
}
]
}
]
},
"summarization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"moderation": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"named_entity_recognition": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"entity": "<string>"
},
"name_consistency": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"custom_spelling": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"speaker_reidentification": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"structured_data_extraction": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"sentiment_analysis": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"audio_to_llm": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {
"prompt": "<string>",
"response": "<string>"
}
}
]
},
"sentences": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
},
"display_mode": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
},
"chapters": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {}
}
}
}
]
}
Authorizations
Your personal Gladia API key
Query Parameters
The starting point for pagination. A value of 0 starts from the first item.
x >= 0
The maximum number of items to return. Useful for pagination and controlling data payload size.
x >= 1
Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
"2025-05-21"
Include items that occurred before the specified date in ISO format.
"2025-05-21T13:26:54.788Z"
Filter for items after the specified date. Use with before_date
for a range. Date in ISO format.
"2025-05-21T13:26:54.788Z"
Filter the list based on item status. Accepts multiple values from the predefined list.
["done"]
Response
A list of pre recorded jobs matching the parameters.
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.gladia.io/v2/pre-recorded \
--header 'x-gladia-key: <api-key>'
{
"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",
"items": [
{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-45463597",
"version": 2,
"status": "queued",
"created_at": "2023-12-28T09:04:17.210Z",
"completed_at": "2023-12-28T09:04:37.210Z",
"custom_metadata": {},
"error_code": 500,
"kind": "pre-recorded",
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"context_prompt": "<string>",
"custom_vocabulary": false,
"custom_vocabulary_config": {
"vocabulary": [
"Westeros",
{
"value": "Stark"
},
{
"value": "Night's Watch",
"pronunciations": [
"Nightz Watch"
],
"intensity": 0.4,
"language": "en"
}
],
"default_intensity": 0.5
},
"detect_language": true,
"enable_code_switching": false,
"code_switching_config": {
"languages": []
},
"language": "en",
"callback_url": "http://callback.example",
"callback": false,
"callback_config": {
"url": "http://callback.example",
"method": "POST"
},
"subtitles": false,
"subtitles_config": {
"formats": [
"srt"
],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": false,
"diarization_config": {
"number_of_speakers": 2,
"min_speakers": 1,
"max_speakers": 2,
"enhanced": false
},
"translation": false,
"translation_config": {
"target_languages": [
"en"
],
"model": "base",
"match_original_utterances": true,
"lipsync": true
},
"summarization": false,
"summarization_config": {
"type": "general"
},
"moderation": false,
"named_entity_recognition": false,
"chapterization": false,
"name_consistency": false,
"custom_spelling": false,
"custom_spelling_config": {
"spelling_dictionary": {
"Gettleman": [
"gettleman"
],
"SQL": [
"Sequel"
]
}
},
"structured_data_extraction": false,
"structured_data_extraction_config": {
"classes": [
"Persons",
"Organizations"
]
},
"sentiment_analysis": false,
"audio_to_llm": false,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
]
},
"sentences": false,
"display_mode": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
},
"audio_url": "<string>"
},
"result": {
"metadata": {
"audio_duration": 3600,
"number_of_distinct_channels": 1,
"billing_time": 3600,
"transcription_time": 20
},
"transcription": {
"full_transcript": "<string>",
"languages": [
"en"
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<string>"
}
],
"utterances": [
{
"language": "en",
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"speaker": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>"
}
]
},
"translation": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"full_transcript": "<string>",
"languages": [
"en"
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<string>"
}
],
"utterances": [
{
"language": "en",
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"speaker": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>"
}
]
}
]
},
"summarization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"moderation": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"named_entity_recognition": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"entity": "<string>"
},
"name_consistency": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"custom_spelling": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"speaker_reidentification": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"structured_data_extraction": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"sentiment_analysis": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": "<string>"
},
"audio_to_llm": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {
"prompt": "<string>",
"response": "<string>"
}
}
]
},
"sentences": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
},
"display_mode": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
},
"chapters": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {}
}
}
}
]
}