Gladia Job History API
The Job History API from Gladia — 1 operation(s) for job history.
The Job History API from Gladia — 1 operation(s) for job history.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/gladia-job-history-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Gladia Control AudioToText Job History API
description: Gladia AI audio infrastructure API for speech-to-text transcription via REST and WebSocket. Supports asynchronous pre-recorded audio processing and real-time live transcription with speaker diarization, automatic language detection across 100+ languages, and audio intelligence features.
version: '1.0'
contact: {}
servers:
- url: https://api.gladia.io/
description: Gladia API production URL
tags:
- name: Job History
paths:
/v1/history:
get:
operationId: HistoryController_getList_v1
parameters:
- name: offset
required: false
in: query
description: The starting point for pagination. A value of 0 starts from the first item.
schema:
minimum: 0
default: 0
type: integer
- name: limit
required: false
in: query
description: The maximum number of items to return. Useful for pagination and controlling data payload size.
schema:
minimum: 1
default: 20
type: integer
- name: date
required: false
in: query
description: Filter items relevant to a specific date in ISO format (YYYY-MM-DD).
schema:
format: date-time
example: '2026-06-12'
type: string
- name: before_date
required: false
in: query
description: Include items that occurred before the specified date in ISO format.
schema:
format: date-time
example: '2026-06-12T21:00:09.947Z'
type: string
- name: after_date
required: false
in: query
description: Filter for items after the specified date. Use with `before_date` for a range. Date in ISO format.
schema:
format: date-time
example: '2026-06-12T21:00:09.947Z'
type: string
- name: status
required: false
in: query
description: Filter the list based on item status. Accepts multiple values from the predefined list.
schema:
example:
- done
type: array
items:
type: string
enum:
- queued
- processing
- done
- error
- name: custom_metadata
required: false
in: query
schema:
additionalProperties: true
example:
user: John Doe
type: object
- name: kind
required: false
in: query
description: Filter the list based on the item type. Supports multiple values from the predefined list.
schema:
example:
- pre-recorded
type: array
items:
type: string
enum:
- pre-recorded
- live
responses:
'200':
description: A list of jobs
content:
application/json:
schema:
$ref: '#/components/schemas/ListHistoryResponse'
security:
- x_gladia_key: []
summary: Get the history of all your jobs
tags:
- Job History
components:
schemas:
TranslationResultDTO:
type: object
properties:
error:
description: Contains the error details of the failed addon
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
full_transcript:
type: string
description: All transcription on text format without any other information
languages:
type: array
description: All the detected languages in the audio sorted from the most detected to the less detected
example:
- en
items:
$ref: '#/components/schemas/TranslationLanguageCodeEnum'
sentences:
description: If `sentences` has been enabled, sentences results for this translation
type: array
items:
$ref: '#/components/schemas/SentencesDTO'
subtitles:
description: If `subtitles` has been enabled, subtitles results for this translation
type: array
items:
$ref: '#/components/schemas/SubtitleDTO'
utterances:
description: Transcribed speech utterances present in the audio
type: array
items:
$ref: '#/components/schemas/UtteranceDTO'
required:
- error
- full_transcript
- languages
- utterances
PreProcessingConfig:
type: object
properties:
audio_enhancer:
type: boolean
description: If true, apply pre-processing to the audio stream to enhance the quality.
default: false
speech_threshold:
type: number
description: Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.
default: 0.6
minimum: 0
maximum: 1
UtteranceDTO:
type: object
properties:
start:
type: number
description: Start timestamp in seconds of this utterance
end:
type: number
description: End timestamp in seconds of this utterance
confidence:
type: number
description: Confidence on the transcribed utterance (1 = 100% confident)
channel:
type: integer
description: Audio channel of where this utterance has been transcribed from
minimum: 0
speaker:
type: integer
description: If `diarization` enabled, speaker identification number
minimum: 0
words:
description: List of words of the utterance, split by timestamp
type: array
items:
$ref: '#/components/schemas/WordDTO'
text:
type: string
description: Transcription for this utterance
language:
description: Spoken language in this utterance
example: en
allOf:
- $ref: '#/components/schemas/TranscriptionLanguageCodeEnum'
required:
- start
- end
- confidence
- channel
- words
- text
- language
CustomVocabularyEntryDTO:
type: object
properties:
value:
type: string
description: The text used to replace in the transcription.
example: Gladia
intensity:
type: number
description: The global intensity of the feature.
example: 0.5
minimum: 0
maximum: 1
pronunciations:
description: The pronunciations used in the transcription.
type: array
items:
type: string
language:
description: Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.
example: en
allOf:
- $ref: '#/components/schemas/TranscriptionLanguageCodeEnum'
required:
- value
TranscriptionResultDTO:
type: object
properties:
metadata:
description: Metadata for the given transcription & audio file
allOf:
- $ref: '#/components/schemas/TranscriptionMetadataDTO'
transcription:
description: Transcription of the audio speech
allOf:
- $ref: '#/components/schemas/TranscriptionDTO'
translation:
description: If `translation` has been enabled, translation of the audio speech transcription
allOf:
- $ref: '#/components/schemas/TranslationDTO'
summarization:
description: If `summarization` has been enabled, summarization of the audio speech transcription
allOf:
- $ref: '#/components/schemas/SummarizationDTO'
moderation:
description: If `moderation` has been enabled, moderation of the audio speech transcription
allOf:
- $ref: '#/components/schemas/ModerationDTO'
named_entity_recognition:
description: If `named_entity_recognition` has been enabled, the detected entities
allOf:
- $ref: '#/components/schemas/NamedEntityRecognitionDTO'
name_consistency:
description: If `name_consistency` has been enabled, Gladia will improve consistency of the names accross the transcription
allOf:
- $ref: '#/components/schemas/NamesConsistencyDTO'
structured_data_extraction:
description: If `structured_data_extraction` has been enabled, structured data extraction results
allOf:
- $ref: '#/components/schemas/StructuredDataExtractionDTO'
sentiment_analysis:
description: If `sentiment_analysis` has been enabled, sentiment analysis of the audio speech transcription
allOf:
- $ref: '#/components/schemas/SentimentAnalysisDTO'
audio_to_llm:
description: If `audio_to_llm` has been enabled, audio to llm results of the audio speech transcription
allOf:
- $ref: '#/components/schemas/AudioToLlmListDTO'
sentences:
description: 'If `sentences` has been enabled, sentences of the audio speech transcription. Deprecated: content will move to the `transcription` object.'
deprecated: true
allOf:
- $ref: '#/components/schemas/SentencesDTO'
display_mode:
description: If `display_mode` has been enabled, the output will be reordered, creating new utterances when speakers overlapped
allOf:
- $ref: '#/components/schemas/DisplayModeDTO'
chapterization:
description: If `chapterization` has been enabled, will generate chapters name for different parts of the given audio.
allOf:
- $ref: '#/components/schemas/ChapterizationDTO'
diarization:
description: If `diarization` has been requested and an error has occurred, the result will appear here
allOf:
- $ref: '#/components/schemas/DiarizationDTO'
required:
- metadata
DiarizationConfigDTO:
type: object
properties:
number_of_speakers:
type: integer
description: Exact number of speakers in the audio
example: 3
minimum: 1
min_speakers:
type: integer
description: Minimum number of speakers in the audio
example: 1
minimum: 0
max_speakers:
type: integer
description: Maximum number of speakers in the audio
example: 2
minimum: 0
ListHistoryResponse:
type: object
properties:
first:
type: string
description: URL to fetch the first page
format: uri
example: https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20
current:
type: string
description: URL to fetch the current page
format: uri
example: https://api.gladia.io/v2/transcription?status=done&offset=0&limit=20
next:
type:
- string
- 'null'
description: URL to fetch the next page
format: uri
example: https://api.gladia.io/v2/transcription?status=done&offset=20&limit=20
items:
description: List of jobs
discriminator:
propertyName: kind
mapping:
pre-recorded: '#/components/schemas/PreRecordedResponse'
live: '#/components/schemas/StreamingResponse'
type: array
items:
oneOf:
- $ref: '#/components/schemas/PreRecordedResponse'
- $ref: '#/components/schemas/StreamingResponse'
required:
- first
- current
- next
- items
SentencesDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
description: If `sentences` has been enabled, transcription as sentences.
type:
- array
- 'null'
items:
type: string
required:
- success
- is_empty
- exec_time
- error
- results
SentimentAnalysisDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
type: string
description: If `sentiment_analysis` has been enabled, Gladia will analyze the sentiments and emotions of the audio
required:
- success
- is_empty
- exec_time
- error
- results
SummarizationConfigDTO:
type: object
properties:
type:
description: The type of summarization to apply
default: general
allOf:
- $ref: '#/components/schemas/SummaryTypesEnum'
FileResponse:
type: object
properties:
id:
type: string
description: The file id
filename:
type:
- string
- 'null'
description: The name of the uploaded file
source:
type:
- string
- 'null'
description: The link used to download the file if audio_url was used
audio_duration:
type:
- number
- 'null'
description: Duration of the audio file
example: 3600
number_of_channels:
type:
- integer
- 'null'
description: Number of channels in the audio file
minimum: 1
example: 1
required:
- id
- filename
- source
- audio_duration
- number_of_channels
SubtitleDTO:
type: object
properties:
format:
description: Format of the current subtitle
example: srt
allOf:
- $ref: '#/components/schemas/SubtitlesFormatEnum'
subtitles:
type: string
description: Transcription on the asked subtitle format
required:
- format
- subtitles
CallbackMethodEnum:
type: string
enum:
- POST
- PUT
description: 'The HTTP method to be used. Allowed values are `POST` or `PUT` (default: `POST`)'
CallbackConfig:
type: object
properties:
url:
type: string
description: URL on which we will do a `POST` request with configured messages
example: https://callback.example
format: uri
receive_partial_transcripts:
type: boolean
description: If true, partial transcript will be sent to the defined callback.
default: false
receive_final_transcripts:
type: boolean
description: If true, final transcript will be sent to the defined callback.
default: true
receive_speech_events:
type: boolean
description: If true, begin and end speech events will be sent to the defined callback.
default: false
receive_pre_processing_events:
type: boolean
description: If true, pre-processing events will be sent to the defined callback.
default: true
receive_realtime_processing_events:
type: boolean
description: If true, realtime processing events will be sent to the defined callback.
default: true
receive_post_processing_events:
type: boolean
description: If true, post-processing events will be sent to the defined callback.
default: true
receive_acknowledgments:
type: boolean
description: If true, acknowledgments will be sent to the defined callback.
default: false
receive_errors:
type: boolean
description: If true, errors will be sent to the defined callback.
default: false
receive_lifecycle_events:
type: boolean
description: If true, lifecycle events will be sent to the defined callback.
default: true
AudioToLlmListConfigDTO:
type: object
properties:
prompts:
description: The list of prompts applied on the audio transcription
example:
- Extract the key points from the transcription
minItems: 1
type: array
items:
type: array
model:
type: string
description: The model to use for the prompt execution. You can find the list of supported models [here](https://openrouter.ai/models).
default: openai/gpt-5.4-nano
required:
- prompts
StreamingSupportedSampleRateEnum:
type: number
enum:
- 8000
- 16000
- 32000
- 44100
- 48000
description: The sample rate of the audio stream
NamedEntityRecognitionDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
description: If `named_entity_recognition` has been enabled, the detected entities.
type:
- array
- 'null'
items:
$ref: '#/components/schemas/NamedEntityRecognitionResult'
required:
- success
- is_empty
- exec_time
- error
- results
TranscriptionLanguageCodeEnum:
type: string
enum:
- af
- am
- ar
- as
- az
- ba
- be
- bg
- bn
- bo
- br
- bs
- ca
- cs
- cy
- da
- de
- el
- en
- es
- et
- eu
- fa
- fi
- fo
- fr
- gl
- gu
- ha
- haw
- he
- hi
- hr
- ht
- hu
- hy
- id
- is
- it
- ja
- jw
- ka
- kk
- km
- kn
- ko
- la
- lb
- ln
- lo
- lt
- lv
- mg
- mi
- mk
- ml
- mn
- mr
- ms
- mt
- my
- ne
- nl
- nn
- 'no'
- oc
- pa
- pl
- ps
- pt
- ro
- ru
- sa
- sd
- si
- sk
- sl
- sn
- so
- sq
- sr
- su
- sv
- sw
- ta
- te
- tg
- th
- tk
- tl
- tr
- tt
- uk
- ur
- uz
- vi
- yi
- yo
- zh
description: Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.
TranscriptionMetadataDTO:
type: object
properties:
audio_duration:
type: number
description: Duration of the transcribed audio file
example: 3600
number_of_distinct_channels:
type: integer
description: Number of distinct channels in the transcribed audio file
minimum: 1
example: 1
billing_time:
type: number
description: Billed duration in seconds (audio_duration * number_of_distinct_channels)
example: 3600
transcription_time:
type: number
description: Duration of the transcription in seconds
example: 20
required:
- audio_duration
- number_of_distinct_channels
- billing_time
- transcription_time
DisplayModeDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
description: If `display_mode` has been enabled, proposes an alternative display output.
type:
- array
- 'null'
items:
type: string
required:
- success
- is_empty
- exec_time
- error
- results
PiiRedactionConfigDTO:
type: object
properties:
entity_types:
description: The entity types to redact
example:
- GDPR
- HEALTH_INFORMATION
- HIPAA_SAFE_HARBOR
- QUEBEC_PRIVACY_ACT
- EMAIL_ADDRESS
- NAME
- PHONE_NUMBER
allOf:
- $ref: '#/components/schemas/PiiRedactionEntityTypeEnum'
processed_text_type:
type: string
description: The type of processed text to return (marker or mask)
enum:
- MARKER
- MASK
example: MARKER
StreamingSupportedBitDepthEnum:
type: number
enum:
- 8
- 16
- 24
- 32
description: The bit depth of the audio stream
SummarizationDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
type:
- string
- 'null'
description: If `summarization` has been enabled, summary of the transcription
required:
- success
- is_empty
- exec_time
- error
- results
TranslationDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
description: List of translated transcriptions, one for each `target_languages`
type:
- array
- 'null'
items:
$ref: '#/components/schemas/TranslationResultDTO'
required:
- success
- is_empty
- exec_time
- error
- results
PostProcessingConfig:
type: object
properties:
summarization:
type: boolean
description: If true, generates summarization for the whole transcription.
default: false
summarization_config:
description: Summarization configuration, if `summarization` is enabled
allOf:
- $ref: '#/components/schemas/SummarizationConfigDTO'
chapterization:
type: boolean
description: If true, generates chapters for the whole transcription.
default: false
TranslationLanguageCodeEnum:
type: string
enum:
- af
- am
- ar
- as
- az
- ba
- be
- bg
- bn
- bo
- br
- bs
- ca
- cs
- cy
- da
- de
- el
- en
- es
- et
- eu
- fa
- fi
- fo
- fr
- gl
- gu
- ha
- haw
- he
- hi
- hr
- ht
- hu
- hy
- id
- is
- it
- ja
- jw
- ka
- kk
- km
- kn
- ko
- la
- lb
- ln
- lo
- lt
- lv
- mg
- mi
- mk
- ml
- mn
- mr
- ms
- mt
- my
- ne
- nl
- nn
- 'no'
- oc
- pa
- pl
- ps
- pt
- ro
- ru
- sa
- sd
- si
- sk
- sl
- sn
- so
- sq
- sr
- su
- sv
- sw
- ta
- te
- tg
- th
- tk
- tl
- tr
- tt
- uk
- ur
- uz
- vi
- wo
- yi
- yo
- zh
description: Target language in `iso639-1` format you want the transcription translated to
DiarizationDTO:
type: object
properties:
success:
type: boolean
description: The audio intelligence model succeeded to get a valid output
is_empty:
type: boolean
description: The audio intelligence model returned an empty value
exec_time:
type: number
description: Time audio intelligence model took to complete the task
error:
description: '`null` if `success` is `true`. Contains the error details of the failed model'
allOf:
- $ref: '#/components/schemas/AddonErrorDTO'
results:
description: '[Deprecated] If `diarization` has been enabled, the diarization result will appear here'
type: array
items:
$ref: '#/components/schemas/UtteranceDTO'
required:
- success
- is_empty
- exec_time
- error
- results
CustomSpellingConfigDTO:
type: object
properties:
spelling_dictionary:
type: object
description: The list of spelling applied on the audio transcription
example:
Gettleman:
- gettleman
SQL:
- Sequel
additionalProperties:
type: array
items:
type: string
required:
- spelling_dictionary
AddonErrorDTO:
type: object
properties:
status_code:
type: integer
description: Status code of the addon error
example: 500
exception:
type: string
description: Reason of the addon error
message:
type: string
description: Detailed message of the addon error
required:
- status_code
- exception
- message
StreamingSupportedEncodingEnum:
type: string
enum:
- wav/pcm
- wav/alaw
- wav/ulaw
description: "The encoding format of the audio stream. Supported formats: \n- PCM: 8, 16, 24, and 32 bits \n- A-law: 8 bits \n- μ-law: 8 bits \n\nNote: No need to add WAV headers to raw audio as the API supports both formats."
RealtimeProcessingConfig:
type: object
properties:
custom_vocabulary:
type: boolean
description: If true, enable custom vocabulary for the transcription.
default: false
custom_vocabulary_config:
description: Custom vocabulary configuration, if `custom_vocabulary` is enabled
allOf:
- $ref: '#/components/schemas/CustomVocabularyConfigDTO'
custom_spelling:
type: boolean
description: If true, enable custom spelling for the transcription.
default: false
custom_spelling_config:
description: Custom spelling configuration, if `custom_spelling` is enabled
allOf:
- $ref: '#/components/schemas/CustomSpellingConfigDTO'
translation:
type: boolean
description: If true, enable translation for the transcription
default: false
translation_config:
description: Translation configuration, if `translation` is enabled
allOf:
- $ref: '#/components/schemas/TranslationConfigDTO'
named_entity_recognition:
type: boolean
description: If true, enable named entity recognition for the transcription.
default: false
sentiment_analysis:
type: boolean
description: If true, enable sentiment analysis for the transcription.
default: false
PiiRedactionEntityTypeEnum:
type: string
enum:
- APPI
- APPI_SENSITIVE
- CCI
- CORE_ENTITIES
- CPRA
- GDPR
- GDPR_SENSITIVE
- HEALTH_INFORMATION
- HIPAA_SAFE_HARBOR
- LIDI
- NUMERICAL_EXCL_PCI
- PCI
- QUEBEC_PRIVACY_ACT
- ACCOUNT_NUMBER
- AGE
- DATE
- DATE_INTERVAL
- DOB
- DRIVER_LICENSE
- DURATION
- EMAIL_ADDRESS
- EVENT
- FILENAME
- GENDER
- HEALTHCARE_NUMBER
- IP_ADDRESS
- LANGUAGE
- LOCATION
- LOCATION_ADDRESS
- LOCATION_ADDRESS_STREET
- LOCATION_CITY
- LOCATION_COORDINATE
- LOCATION_COUNTRY
- LOCATION_STATE
- LOCATION_ZIP
- MARITAL_STATUS
- MONEY
- NAME
- NAME_FAMILY
- NAME_GIVEN
- NAME_MEDICAL_PROFESSIONAL
- NUMERICAL_PII
- OCCUPATION
- ORGANIZATION
- ORGANIZATION_MEDICAL_FACILITY
- ORIGIN
- PASSPORT_NUMBER
- PASSWORD
- PHONE_NUMBER
- PHYSICAL_ATTRIBUTE
- POLITICAL_AFFILIATION
- RELIGION
- SEXUALITY
- SSN
- TIME
- URL
- USERNAME
- VEHICLE_ID
- ZODIAC_SIGN
- BLOOD_TYPE
- CONDITION
- DOSE
- DRUG
- INJURY
- MEDICAL_PROCESS
- STATISTICS
- BANK_ACCOUNT
- CREDIT_CARD
- CREDIT_CARD_EXPIRATION
- CVV
- ROUTING_NUMBER
- CORPORATE_ACTION
- DAY
- EFFECT
- FINANCIAL_METRIC
- MEDICAL_CODE
- MONTH
- ORGANIZATION_ID
- PRODUCT
- PROJECT
- TREND
- YEAR
description: The entity types to redact
StreamingResponse:
type: object
properties:
id:
type: string
description: Id of the job
format: uuid
example: 45463597-20b7-4af7-b3b3-f5fb778203ab
request_id:
type: string
description: Debug id
example: G-45463597
version:
type: integer
description: API version
example: 2
status:
type: string
description: '"queued": the job has been queued. "processing": the job is being processed. "done": the job has been processed and the result is available. "error": an error occurred during the job''s processing.'
enum:
- queued
- processing
- done
- error
created_at:
type: string
description: Creation date
format: date-time
example: '2023-12-28T09:04:17.210Z'
completed_at:
type:
- string
- 'null'
description: Completion da
# --- truncated at 32 KB (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gladia/refs/heads/main/openapi/gladia-job-history-api-openapi.yml