# 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.

## Parameters

- `id` (path, string, required, uuid): 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, one of: `queued`, `processing`, `done`, `error`): `queued`: created, no WebSocket yet; `processing`: streaming (or dropped and still resumable); `done`: ended, the result is there; `error`: the session failed.
- `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.
  - `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`.
  - `metadata` (object, required)
    - `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)
    - `languages` (array of string, required): Languages heard, in order of appearance.
    - `utterances` (array of object, required): Every final utterance, by start time.
      - `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, default: `null`): Speaker number, with `diarization`.
      - `words` (array of object, required): The words with their timestamps.
        - `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, default: `null`): Speaker of the word, with `diarization`.
      - `text_raw` (string, default: `null`): The transcript without inline elements (with named entity recognition; never with PII redaction).
      - `entities` (array of object, default: `null`): The entities of the utterance, with named entity recognition or PII redaction.
        - `label` (string, default: `null`): Entity type, for example `name`, `phone_number`, `location_city`.
        - `id` (integer, default: `null`): The entity's number in the session, per type: the same person is always the same number.
        - `action` (string, default: `null`): `ner`: tagged; otherwise how the personal data was redacted.
        - `score` (number, default: `null`): Confidence, from 0 to 1.
        - `text` (string, default: `null`): The entity as heard (never sent for masked personal data unless `pii.return_entities`).
        - `start` (integer, default: `null`): Offset of the entity's element in `text`, in characters.
        - `end` (integer, default: `null`): End offset of the entity's element in `text`, in characters.
      - `forced` ("max_duration", default: `null`): Set when the utterance was closed by `maximum_duration_without_endpointing` rather than by a pause.
    - `full_transcript` (string, required): The final utterances' text, joined.
  - `translation` (object, default: `null`): With `realtime_processing.translation`.
    - `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.
      - `error` (any, default: `null`): Always `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.
        - `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, default: `null`): Speaker number, with `diarization`.
        - `words` (array of object, required): The words with their timestamps.
        - `text_raw` (string, default: `null`): The transcript without inline elements (with named entity recognition; never with PII redaction).
        - `entities` (array of object, default: `null`): The entities of the utterance, with named entity recognition or PII redaction.
        - `forced` ("max_duration", default: `null`): Set when the utterance was closed by `maximum_duration_without_endpointing` rather than by a pause.
      - `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.

```json
{
  "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.

### 403

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

### 404

No such session for your account.

### 503

The service cannot answer right now: try again.

## Example

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