---
title: "Get the live job's metadata"
method: GET
path: "/v2/live/{id}"
tags: ["Live V2"]
---

# Get the live job's metadata

`GET /v2/live/{id}`

## Path parameters

- `id` string, required

## Response `200`

The live job's metadata

- StreamingResponse
  - `id` string, uuid, required — Id of the job
  - `request_id` string, required — Debug id
  - `version` integer, required — API version
  - `status` 'queued' | 'processing' | 'done' | 'error', required — "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.
  - `created_at` string, date-time, required — Creation date
  - `completed_at` string, date-time, nullable — Completion date when status is "done" or "error"
  - `custom_metadata` object — Custom metadata given in the initial request
  - `error_code` integer, nullable — HTTP status code of the error if status is "error"
  - `post_session_metadata` object, required — For debugging purposes, send data that could help to identify issues
  - `kind` 'live', required
  - `file` FileResponse
    - `id` string, required — The file id
    - `filename` string, nullable, required — The name of the uploaded file
    - `source` string, nullable, required — The link used to download the file if audio_url was used
    - `audio_duration` number, nullable, required — Duration of the audio file
    - `number_of_channels` integer, nullable, required — Number of channels in the audio file
  - `request_params` StreamingRequestParamsResponse
    - `encoding` 'wav/pcm' | 'wav/alaw' | 'wav/ulaw' — The encoding format of the audio stream. Supported formats: - PCM: 8, 16, 24, and 32 bits - A-law: 8 bits - μ-law: 8 bits Note: No need to add WAV headers to raw audio as the API supports both formats.
    - `bit_depth` 8 | 16 | 24 | 32 — The bit depth of the audio stream
    - `sample_rate` 8000 | 16000 | 32000 | 44100 | 48000 — The sample rate of the audio stream
    - `channels` integer — The number of channels of the audio stream
    - `model` 'solaria-1' — The model used to process the audio. "solaria-1" is used by default.
    - `endpointing` number — The endpointing duration in seconds. Endpointing is the duration of silence which will cause an utterance to be considered as finished
    - `maximum_duration_without_endpointing` number — The maximum duration in seconds without endpointing. If endpointing is not detected after this duration, current utterance will be considered as finished
    - `language_config` LanguageConfig
      - `languages` TranscriptionLanguageCodeEnum[] — If one language is set, it will be used for the transcription. Otherwise, language will be auto-detected by the model.
      - `code_switching` boolean — If true, language will be auto-detected on each utterance. Otherwise, language will be auto-detected on first utterance and then used for the rest of the transcription. If one language is set, this option will be ignored.
    - `pre_processing` PreProcessingConfig
      - `audio_enhancer` boolean — If true, apply pre-processing to the audio stream to enhance the quality.
      - `speech_threshold` number — Sensitivity configuration for Speech Threshold. A value close to 1 will apply stricter thresholds, making it less likely to detect background sounds as speech.
    - `realtime_processing` RealtimeProcessingConfig
      - `custom_vocabulary` boolean — If true, enable custom vocabulary for the transcription.
      - `custom_vocabulary_config` CustomVocabularyConfigDTO
        - `vocabulary` union[], required — Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.
          - union
            - CustomVocabularyEntryDTO
              - …
            - string
        - `default_intensity` number — Default intensity for the custom vocabulary
      - `custom_spelling` boolean — If true, enable custom spelling for the transcription.
      - `custom_spelling_config` CustomSpellingConfigDTO
        - `spelling_dictionary` object, required — The list of spelling applied on the audio transcription
      - `translation` boolean — If true, enable translation for the transcription
      - `translation_config` TranslationConfigDTO
        - `target_languages` TranslationLanguageCodeEnum[], required — Target language in `iso639-1` format you want the transcription translated to
        - `model` 'base' | 'batch' | 'enhanced' — Model you want the translation model to use to translate
        - `match_original_utterances` boolean — Align translated utterances with the original ones
        - `lipsync` boolean — Whether to apply lipsync to the translated transcription.
        - `context_adaptation` boolean — Enables or disables context-aware translation features that allow the model to adapt translations based on provided context.
        - `context` string — Context information to improve translation accuracy
        - `informal` boolean — Forces the translation to use informal language forms when available in the target language.
      - `named_entity_recognition` boolean — If true, enable named entity recognition for the transcription.
      - `sentiment_analysis` boolean — If true, enable sentiment analysis for the transcription.
    - `post_processing` PostProcessingConfig
      - `summarization` boolean — If true, generates summarization for the whole transcription.
      - `summarization_config` SummarizationConfigDTO
        - `type` 'general' | 'bullet_points' | 'concise' — The type of summarization to apply
      - `chapterization` boolean — If true, generates chapters for the whole transcription.
    - `messages_config` MessagesConfig
      - `receive_partial_transcripts` boolean — If true, partial transcript will be sent to websocket.
      - `receive_final_transcripts` boolean — If true, final transcript will be sent to websocket.
      - `receive_speech_events` boolean — If true, begin and end speech events will be sent to websocket.
      - `receive_pre_processing_events` boolean — If true, pre-processing events will be sent to websocket.
      - `receive_realtime_processing_events` boolean — If true, realtime processing events will be sent to websocket.
      - `receive_post_processing_events` boolean — If true, post-processing events will be sent to websocket.
      - `receive_acknowledgments` boolean — If true, acknowledgments will be sent to websocket.
      - `receive_errors` boolean — If true, errors will be sent to websocket.
      - `receive_lifecycle_events` boolean — If true, lifecycle events will be sent to websocket.
    - `callback` boolean — If true, messages will be sent to configured url.
    - `callback_config` CallbackConfig
      - `url` string, uri — URL on which we will do a `POST` request with configured messages
      - `receive_partial_transcripts` boolean — If true, partial transcript will be sent to the defined callback.
      - `receive_final_transcripts` boolean — If true, final transcript will be sent to the defined callback.
      - `receive_speech_events` boolean — If true, begin and end speech events will be sent to the defined callback.
      - `receive_pre_processing_events` boolean — If true, pre-processing events will be sent to the defined callback.
      - `receive_realtime_processing_events` boolean — If true, realtime processing events will be sent to the defined callback.
      - `receive_post_processing_events` boolean — If true, post-processing events will be sent to the defined callback.
      - `receive_acknowledgments` boolean — If true, acknowledgments will be sent to the defined callback.
      - `receive_errors` boolean — If true, errors will be sent to the defined callback.
      - `receive_lifecycle_events` boolean — If true, lifecycle events will be sent to the defined callback.
  - `result` StreamingTranscriptionResultWithMessagesDTO
    - `metadata` TranscriptionMetadataDTO, required
      - `audio_duration` number, required — Duration of the transcribed audio file
      - `number_of_distinct_channels` integer, required — Number of distinct channels in the transcribed audio file
      - `billing_time` number, required — Billed duration in seconds (audio_duration * number_of_distinct_channels)
      - `transcription_time` number, required — Duration of the transcription in seconds
    - `transcription` TranscriptionDTO
      - `full_transcript` string, required — All transcription on text format without any other information
      - `languages` TranscriptionLanguageCodeEnum[], required — All the detected languages in the audio sorted from the most detected to the less detected
      - `sentences` SentencesDTO[] — If `sentences` has been enabled, sentences results
        - `success` boolean, required — The audio intelligence model succeeded to get a valid output
        - `is_empty` boolean, required — The audio intelligence model returned an empty value
        - `exec_time` number, required — Time audio intelligence model took to complete the task
        - `error` AddonErrorDTO, required
          - `status_code` integer, required — Status code of the addon error
          - `exception` string, required — Reason of the addon error
          - `message` string, required — Detailed message of the addon error
        - `results` string[], nullable, required — If `sentences` has been enabled, transcription as sentences.
      - `subtitles` SubtitleDTO[] — If `subtitles` has been enabled, subtitles results
        - `format` 'srt' | 'vtt', required — Subtitles formats you want your transcription to be formatted to
        - `subtitles` string, required — Transcription on the asked subtitle format
      - `utterances` UtteranceDTO[], required — Transcribed speech utterances present in the audio
        - `start` number, required — Start timestamp in seconds of this utterance
        - `end` number, required — End timestamp in seconds of this utterance
        - `confidence` number, required — Confidence on the transcribed utterance (1 = 100% confident)
        - `channel` integer, required — Audio channel of where this utterance has been transcribed from
        - `speaker` integer — If `diarization` enabled, speaker identification number
        - `words` WordDTO[], required — List of words of the utterance, split by timestamp
          - `word` string, required — Spoken word
          - `start` number, required — Start timestamps in seconds of the spoken word
          - `end` number, required — End timestamps in seconds of the spoken word
          - `confidence` number, required — Confidence on the transcribed word (1 = 100% confident)
        - `text` string, required — Transcription for this utterance
        - `language` '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', required — Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.
    - `translation` TranslationDTO
      - `success` boolean, required — The audio intelligence model succeeded to get a valid output
      - `is_empty` boolean, required — The audio intelligence model returned an empty value
      - `exec_time` number, required — Time audio intelligence model took to complete the task
      - `error` AddonErrorDTO, required
        - `status_code` integer, required — Status code of the addon error
        - `exception` string, required — Reason of the addon error
        - `message` string, required — Detailed message of the addon error
      - `results` TranslationResultDTO[], nullable, required — List of translated transcriptions, one for each `target_languages`
        - `error` AddonErrorDTO, required
          - `status_code` integer, required — Status code of the addon error
          - `exception` string, required — Reason of the addon error
          - `message` string, required — Detailed message of the addon error
        - `full_transcript` string, required — All transcription on text format without any other information
        - `languages` TranslationLanguageCodeEnum[], required — All the detected languages in the audio sorted from the most detected to the less detected
        - `sentences` SentencesDTO[] — If `sentences` has been enabled, sentences results for this translation
          - `success` boolean, required — The audio intelligence model succeeded to get a valid output
          - `is_empty` boolean, required — The audio intelligence model returned an empty value
          - `exec_time` number, required — Time audio intelligence model took to complete the task
          - `error` AddonErrorDTO, required
            - `status_code` integer, required — Status code of the addon error
            - `exception` string, required — Reason of the addon error
            - `message` string, required — Detailed message of the addon error
          - `results` string[], nullable, required — If `sentences` has been enabled, transcription as sentences.
        - `subtitles` SubtitleDTO[] — If `subtitles` has been enabled, subtitles results for this translation
          - `format` 'srt' | 'vtt', required — Subtitles formats you want your transcription to be formatted to
          - `subtitles` string, required — Transcription on the asked subtitle format
        - `utterances` UtteranceDTO[], required — Transcribed speech utterances present in the audio
          - `start` number, required — Start timestamp in seconds of this utterance
          - `end` number, required — End timestamp in seconds of this utterance
          - `confidence` number, required — Confidence on the transcribed utterance (1 = 100% confident)
          - `channel` integer, required — Audio channel of where this utterance has been transcribed from
          - `speaker` integer — If `diarization` enabled, speaker identification number
          - `words` WordDTO[], required — List of words of the utterance, split by timestamp
            - `word` string, required — Spoken word
            - `start` number, required — Start timestamps in seconds of the spoken word
            - `end` number, required — End timestamps in seconds of the spoken word
            - `confidence` number, required — Confidence on the transcribed word (1 = 100% confident)
          - `text` string, required — Transcription for this utterance
          - `language` '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', required — Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.
    - `summarization` SummarizationDTO
      - `success` boolean, required — The audio intelligence model succeeded to get a valid output
      - `is_empty` boolean, required — The audio intelligence model returned an empty value
      - `exec_time` number, required — Time audio intelligence model took to complete the task
      - `error` AddonErrorDTO, required
        - `status_code` integer, required — Status code of the addon error
        - `exception` string, required — Reason of the addon error
        - `message` string, required — Detailed message of the addon error
      - `results` string, nullable, required — If `summarization` has been enabled, summary of the transcription
    - `named_entity_recognition` NamedEntityRecognitionDTO
      - `success` boolean, required — The audio intelligence model succeeded to get a valid output
      - `is_empty` boolean, required — The audio intelligence model returned an empty value
      - `exec_time` number, required — Time audio intelligence model took to complete the task
      - `error` AddonErrorDTO, required
        - `status_code` integer, required — Status code of the addon error
        - `exception` string, required — Reason of the addon error
        - `message` string, required — Detailed message of the addon error
      - `results` NamedEntityRecognitionResult[], nullable, required — If `named_entity_recognition` has been enabled, the detected entities.
        - `entity_type` string, required
        - `text` string, required
        - `start` number, required
        - `end` number, required
    - `sentiment_analysis` SentimentAnalysisDTO
      - `success` boolean, required — The audio intelligence model succeeded to get a valid output
      - `is_empty` boolean, required — The audio intelligence model returned an empty value
      - `exec_time` number, required — Time audio intelligence model took to complete the task
      - `error` AddonErrorDTO, required
        - `status_code` integer, required — Status code of the addon error
        - `exception` string, required — Reason of the addon error
        - `message` string, required — Detailed message of the addon error
      - `results` string, required — If `sentiment_analysis` has been enabled, Gladia will analyze the sentiments and emotions of the audio
    - `chapterization` ChapterizationDTO
      - `success` boolean, required — The audio intelligence model succeeded to get a valid output
      - `is_empty` boolean, required — The audio intelligence model returned an empty value
      - `exec_time` number, required — Time audio intelligence model took to complete the task
      - `error` AddonErrorDTO, required
        - `status_code` integer, required — Status code of the addon error
        - `exception` string, required — Reason of the addon error
        - `message` string, required — Detailed message of the addon error
      - `results` object, nullable, required — If `chapterization` has been enabled, will generate chapters name for different parts of the given audio.
    - `messages` string[] — Real-Time messages sent by the server during the live transcription

## Other responses

- `401` — You don't have the permissions to access the live job
- `404` — The live job doesn't exist or has been deleted

---

[API](https://skmtc.net/gladia/apis/gladia-control-api.md) · [All operations](https://skmtc.net/gladia/apis/gladia-control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gladia/gladia-control-api/versions/8ec9ebfee489/schema)