Get a session

GET /v2/live/{id}

A session's status and options and, once it ended, its transcript.

Authentication: your API key in the x-gladia-key header (Authentication).

Example

curl https://eu1.api.gladia.io/v2/live/0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b \
  -H "x-gladia-key: $GLADIA_API_KEY"

import os

from gladiaio_sdk import GladiaClient

client = GladiaClient(
    api_key=os.environ["GLADIA_API_KEY"],
    api_url=os.environ.get("GLADIA_API_URL", "https://eu1.api.gladia.io"),
)

session = client.live_v2().get("0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b")
print(session.status, session.result)

import { GladiaClient } from "@gladiaio/sdk";

const client = new GladiaClient({
  apiKey: process.env.GLADIA_API_KEY,
  apiUrl: process.env.GLADIA_API_URL ?? "https://eu1.api.gladia.io",
});

const session = await client.liveV2().get("0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b");
console.log(session.status, session.result);

Try it

API address API key (kept in this tab only) id (path, required)

Parameters

id string · path required

Identifier of the session (id of POST /v2/live).

Responses

200 The session.

id string required

Identifier of the session.
request_id string required

Identifier to quote to support.
version 2

default: 2
status string required

queued: created, no WebSocket yet; processing: streaming (or dropped and still resumable); done: ended, the result is there; error: the session failed.

one of: queued, processing, done, error
created_at string required

Creation date (ISO 8601, UTC).
completed_at string required

End date, once done or error.
custom_metadata object required

The init body's custom_metadata.
error_code integer required

500 when the session failed, else null.
kind "live"

default: "live"
file object required

The session's audio, once it ended.
5 fields
- id string required
  
  Identifier of the session.
- filename string required
  
  Name of the recording, null when the audio was not recorded.
- source string required
  
  Download URL of the recording (GET /v2/live/{id}/file), null when not recorded.
- audio_duration number required
  
  Audio received, in seconds.
- number_of_channels integer required
request_params object required

The session's options, as validated.
result object required

The transcript, once done.
4 fields
- metadata object required
  4 fields
  - audio_duration number required
    
    Audio received, in seconds.
  - billing_time number required
    
    Billed duration, in seconds.
  - number_of_distinct_channels integer required
    
    Number of audio channels.
  - transcription_time number required
    
    How long the session ran, in seconds.
- transcription object required
  3 fields
  - languages array of string required
    
    Languages heard, in order of appearance.
  - utterances array of object required
    
    Every final utterance, by start time.
    
    11 fields
    
    text string required
    
    The transcript. With named entity recognition or PII redaction on, it carries their inline elements (<ner:name id="1">…</ner:name>, <pii:email id="1"/>).
    
    start number required
    
    Start, in seconds from the start of the audio.
    
    end number required
    
    End, in seconds from the start of the audio.
    
    language string required
    
    Language spoken (ISO 639-1).
    
    confidence number required
    
    Confidence, from 0 to 1.
    
    channel integer required
    
    Audio channel the utterance was heard on, from 0.
    
    speaker integer
    
    Speaker number, with diarization.
    
    default: null
    
    words array of object required
    
    The words with their timestamps.
    
    5 fields
    
    word string required
    
    The word, with its leading space when it follows another.
    
    start number required
    
    Start of the word, in seconds from the start of the audio.
    
    end number required
    
    End of the word, in seconds from the start of the audio.
    
    confidence number required
    
    Confidence, from 0 to 1.
    
    speaker integer
    
    Speaker of the word, with diarization.
    
    default: null
    
    text_raw string
    
    The transcript without inline elements (with named entity recognition; never with PII redaction).
    
    default: null
    
    entities array of object
    
    The entities of the utterance, with named entity recognition or PII redaction.
    
    default: null
    
    7 fields
    
    label string
    
    Entity type, for example name, phone_number, location_city.
    
    default: null
    
    id integer
    
    The entity's number in the session, per type: the same person is always the same number.
    
    default: null
    
    action string
    
    ner: tagged; otherwise how the personal data was redacted.
    
    default: null
    
    score number
    
    Confidence, from 0 to 1.
    
    default: null
    
    text string
    
    The entity as heard (never sent for masked personal data unless pii.return_entities).
    
    default: null
    
    start integer
    
    Offset of the entity's element in text, in characters.
    
    default: null
    
    end integer
    
    End offset of the entity's element in text, in characters.
    
    default: null
    
    forced "max_duration"
    
    Set when the utterance was closed by maximum_duration_without_endpointing rather than by a pause.
    
    default: null
  - full_transcript string required
    
    The final utterances' text, joined.
- translation object
  
  With realtime_processing.translation.
  
  default: null
  5 fields
  - success boolean required
  - is_empty boolean required
    
    true when nothing was translated.
  - exec_time number required
  - error any
    
    default: null
  - results array of object required
    
    One result per target language.
    
    6 fields
    
    error any
    
    Always null.
    
    default: null
    
    languages array of string required
    
    The target language of this result.
    
    full_transcript string required
    
    The translated text, joined.
    
    utterances array of object required
    
    The translated utterances, one per final.
    
    11 fields
    
    text string required
    
    The transcript. With named entity recognition or PII redaction on, it carries their inline elements (<ner:name id="1">…</ner:name>, <pii:email id="1"/>).
    
    start number required
    
    Start, in seconds from the start of the audio.
    
    end number required
    
    End, in seconds from the start of the audio.
    
    language string required
    
    Language spoken (ISO 639-1).
    
    confidence number required
    
    Confidence, from 0 to 1.
    
    channel integer required
    
    Audio channel the utterance was heard on, from 0.
    
    speaker integer
    
    Speaker number, with diarization.
    
    default: null
    
    words array of object required
    
    The words with their timestamps.
    
    text_raw string
    
    The transcript without inline elements (with named entity recognition; never with PII redaction).
    
    default: null
    
    entities array of object
    
    The entities of the utterance, with named entity recognition or PII redaction.
    
    default: null
    
    forced "max_duration"
    
    Set when the utterance was closed by maximum_duration_without_endpointing rather than by a pause.
    
    default: null
    
    sentences array of any required
    
    Always empty.
    
    subtitles array of any required
    
    Always empty.
- messages array of any required
  
  The final transcript messages, as sent on the WebSocket.

{
  "id": "0199d7a2-5c3e-7b41-9f0a-3c2d1e4f5a6b",
  "request_id": "G-0199d7a2",
  "version": 2,
  "status": "queued",
  "created_at": "string",
  "completed_at": "string",
  "custom_metadata": {},
  "error_code": 0,
  "kind": "live",
  "file": {
    "id": "string",
    "filename": "string",
    "source": "string",
    "audio_duration": 0.5,
    "number_of_channels": 0
  },
  "request_params": {},
  "result": {
    "metadata": {
      "audio_duration": 0.5,
      "billing_time": 0.5,
      "number_of_distinct_channels": 0,
      "transcription_time": 0.5
    },
    "transcription": {
      "languages": [
        "string"
      ],
      "utterances": [
        {
          "text": "Hello, how can I help you?",
          "start": 0.5,
          "end": 0.5,
          "language": "en",
          "confidence": 0.5,
          "channel": 0,
          "speaker": 0,
          "words": [],
          "text_raw": "string",
          "entities": [],
          "forced": "max_duration"
        }
      ],
      "full_transcript": "string"
    },
    "translation": {
      "success": false,
      "is_empty": false,
      "exec_time": 0.5,
      "error": null,
      "results": [
        {
          "error": null,
          "languages": [],
          "full_transcript": "string",
          "utterances": [],
          "sentences": [],
          "subtitles": []
        }
      ]
    },
    "messages": [
      null
    ]
  }
}

401 No API key, or an unknown one.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

403 The key may not do this (its scopes, or the addresses it may be used from).

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

404 No such session for your account.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}

503 The service cannot answer right now: try again.

{
  "statusCode": 400,
  "timestamp": "2026-10-12T09:04:17.210Z",
  "path": "/v2/live",
  "message": "Invalid parameter(s). See validation_errors for more details.",
  "request_id": "G-1a2b3c4d",
  "validation_errors": [
    "sample_rate Input should be 8000, 16000, 32000, 44100 or 48000"
  ],
  "error": "string"
}