Get pre recorded jobs based on query parameters
curl --request GET \
--url https://api.gladia.io/v2/pre-recorded \
--header 'x-gladia-key: <api-key>'import requests
url = "https://api.gladia.io/v2/pre-recorded"
headers = {"x-gladia-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-gladia-key': '<api-key>'}};
fetch('https://api.gladia.io/v2/pre-recorded', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gladia.io/v2/pre-recorded",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-gladia-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gladia.io/v2/pre-recorded"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-gladia-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gladia.io/v2/pre-recorded")
.header("x-gladia-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gladia.io/v2/pre-recorded")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-gladia-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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,
"created_at": "2023-12-28T09:04:17.210Z",
"post_session_metadata": {},
"kind": "pre-recorded",
"completed_at": "2023-12-28T09:04:37.210Z",
"custom_metadata": {
"user": "John Doe"
},
"error_code": 500,
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"audio_url": "<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
},
"callback_url": "https://callback.example",
"callback": false,
"callback_config": {
"url": "https://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": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": false,
"translation_config": {
"target_languages": [
"en"
],
"model": "base",
"match_original_utterances": true,
"lipsync": true,
"context_adaptation": true,
"context": "<string>",
"informal": false
},
"summarization": false,
"summarization_config": {
"type": "general"
},
"named_entity_recognition": false,
"custom_spelling": false,
"custom_spelling_config": {
"spelling_dictionary": {
"Gettleman": [
"gettleman"
],
"SQL": [
"Sequel"
]
}
},
"sentiment_analysis": false,
"audio_to_llm": false,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
],
"model": "openai/gpt-5.4-nano"
},
"pii_redaction": false,
"pii_redaction_config": {
"entity_types": [
"GDPR",
"HEALTH_INFORMATION",
"HIPAA_SAFE_HARBOR",
"QUEBEC_PRIVACY_ACT",
"EMAIL_ADDRESS",
"NAME",
"PHONE_NUMBER"
],
"processed_text_type": "MARKER"
},
"sentences": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
}
},
"result": {
"metadata": {
"audio_duration": 3600,
"number_of_distinct_channels": 1,
"billing_time": 3600,
"transcription_time": 20
},
"transcription": {
"full_transcript": "<string>",
"languages": [
"en"
],
"utterances": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<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"
],
"utterances": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<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>"
},
"results": [
{
"entity_type": "<string>",
"text": "<string>",
"start": 123,
"end": 123
}
]
},
"name_consistency": {
"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>"
]
},
"chapterization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {}
},
"diarization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
]
}
}
}
]
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 401,
"message": "gladia key not found"
}List transcriptions
List all the pre-recorded transcriptions matching the parameters.
GET
/
v2
/
pre-recorded
Get pre recorded jobs based on query parameters
curl --request GET \
--url https://api.gladia.io/v2/pre-recorded \
--header 'x-gladia-key: <api-key>'import requests
url = "https://api.gladia.io/v2/pre-recorded"
headers = {"x-gladia-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-gladia-key': '<api-key>'}};
fetch('https://api.gladia.io/v2/pre-recorded', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gladia.io/v2/pre-recorded",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-gladia-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.gladia.io/v2/pre-recorded"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-gladia-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.gladia.io/v2/pre-recorded")
.header("x-gladia-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gladia.io/v2/pre-recorded")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-gladia-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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,
"created_at": "2023-12-28T09:04:17.210Z",
"post_session_metadata": {},
"kind": "pre-recorded",
"completed_at": "2023-12-28T09:04:37.210Z",
"custom_metadata": {
"user": "John Doe"
},
"error_code": 500,
"file": {
"id": "<string>",
"filename": "<string>",
"source": "<string>",
"audio_duration": 3600,
"number_of_channels": 1
},
"request_params": {
"audio_url": "<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
},
"callback_url": "https://callback.example",
"callback": false,
"callback_config": {
"url": "https://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": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": false,
"translation_config": {
"target_languages": [
"en"
],
"model": "base",
"match_original_utterances": true,
"lipsync": true,
"context_adaptation": true,
"context": "<string>",
"informal": false
},
"summarization": false,
"summarization_config": {
"type": "general"
},
"named_entity_recognition": false,
"custom_spelling": false,
"custom_spelling_config": {
"spelling_dictionary": {
"Gettleman": [
"gettleman"
],
"SQL": [
"Sequel"
]
}
},
"sentiment_analysis": false,
"audio_to_llm": false,
"audio_to_llm_config": {
"prompts": [
"Extract the key points from the transcription"
],
"model": "openai/gpt-5.4-nano"
},
"pii_redaction": false,
"pii_redaction_config": {
"entity_types": [
"GDPR",
"HEALTH_INFORMATION",
"HIPAA_SAFE_HARBOR",
"QUEBEC_PRIVACY_ACT",
"EMAIL_ADDRESS",
"NAME",
"PHONE_NUMBER"
],
"processed_text_type": "MARKER"
},
"sentences": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
}
},
"result": {
"metadata": {
"audio_duration": 3600,
"number_of_distinct_channels": 1,
"billing_time": 3600,
"transcription_time": 20
},
"transcription": {
"full_transcript": "<string>",
"languages": [
"en"
],
"utterances": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<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"
],
"utterances": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
],
"sentences": [
{
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
"<string>"
]
}
],
"subtitles": [
{
"format": "srt",
"subtitles": "<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>"
},
"results": [
{
"entity_type": "<string>",
"text": "<string>",
"start": 123,
"end": 123
}
]
},
"name_consistency": {
"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>"
]
},
"chapterization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": {}
},
"diarization": {
"success": true,
"is_empty": true,
"exec_time": 123,
"error": {
"status_code": 500,
"exception": "<string>",
"message": "<string>"
},
"results": [
{
"start": 123,
"end": 123,
"confidence": 123,
"channel": 1,
"words": [
{
"word": "<string>",
"start": 123,
"end": 123,
"confidence": 123
}
],
"text": "<string>",
"language": "en",
"speaker": 1
}
]
}
}
}
]
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 401,
"message": "gladia key not found"
}Authorizations
Your personal Gladia API key
Query Parameters
The starting point for pagination. A value of 0 starts from the first item.
Required range:
x >= 0The maximum number of items to return. Useful for pagination and controlling data payload size.
Required range:
x >= 1Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
Example:
"2026-07-10"
Include items that occurred before the specified date in ISO format.
Example:
"2026-07-10T13:51:13.339Z"
Filter for items after the specified date. Use with before_date for a range. Date in ISO format.
Example:
"2026-07-10T13:51:13.339Z"
Filter the list based on item status. Accepts multiple values from the predefined list.
Available options:
queued, processing, done, error Example:
["done"]
Example:
{ "user": "John Doe" }
Response
A list of pre recorded jobs matching the parameters.
URL to fetch the first page
Example:
"https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20"
URL to fetch the current page
Example:
"https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20"
URL to fetch the next page
Example:
"https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20"
List of pre-recorded transcriptions
Show child attributes
Show child attributes
⌘I