GET
/
v2
/
live
curl --request GET \
  --url https://api.gladia.io/v2/live \
  --header 'x-gladia-key: <api-key>'
{
  "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,
      "status": "queued",
      "created_at": "2023-12-28T09:04:17.210Z",
      "completed_at": "2023-12-28T09:04:37.210Z",
      "custom_metadata": {},
      "error_code": 500,
      "kind": "live",
      "file": {
        "id": "<string>",
        "filename": "<string>",
        "source": "<string>",
        "audio_duration": 3600,
        "number_of_channels": 1
      },
      "request_params": {
        "encoding": "wav/pcm",
        "bit_depth": 16,
        "sample_rate": 16000,
        "channels": 1,
        "model": "accurate",
        "endpointing": 0.01,
        "maximum_duration_without_endpointing": 5,
        "language_config": {
          "languages": [],
          "code_switching": false
        },
        "pre_processing": {
          "audio_enhancer": false,
          "speech_threshold": 0.8
        },
        "realtime_processing": {
          "words_accurate_timestamps": false,
          "custom_vocabulary": false,
          "custom_vocabulary_config": {
            "vocabulary": [
              "Gladia",
              {
                "value": "Gladia",
                "intensity": 0.5
              }
            ],
            "default_intensity": 0.5
          },
          "translation": false,
          "translation_config": {
            "target_languages": [
              "en"
            ],
            "model": "base",
            "match_original_utterances": true
          },
          "named_entity_recognition": false,
          "sentiment_analysis": false
        },
        "post_processing": {
          "summarization": false,
          "summarization_config": {
            "type": "general"
          },
          "chapterization": false
        },
        "messages_config": {
          "receive_partial_transcripts": true,
          "receive_final_transcripts": true,
          "receive_speech_events": true,
          "receive_pre_processing_events": true,
          "receive_realtime_processing_events": true,
          "receive_post_processing_events": true,
          "receive_acknowledgments": true,
          "receive_errors": true,
          "receive_lifecycle_events": false
        },
        "callback": false,
        "callback_config": {
          "url": "https://callback.example",
          "receive_partial_transcripts": false,
          "receive_final_transcripts": true,
          "receive_speech_events": false,
          "receive_pre_processing_events": true,
          "receive_realtime_processing_events": true,
          "receive_post_processing_events": true,
          "receive_acknowledgments": false,
          "receive_errors": false,
          "receive_lifecycle_events": true
        }
      },
      "result": {
        "metadata": {
          "audio_duration": 3600,
          "number_of_distinct_channels": 1,
          "billing_time": 3600,
          "transcription_time": 20
        },
        "transcription": {
          "full_transcript": "<string>",
          "languages": [
            "en"
          ],
          "sentences": [
            {
              "success": true,
              "is_empty": true,
              "exec_time": 123,
              "error": {
                "status_code": 500,
                "exception": "<string>",
                "message": "<string>"
              },
              "results": [
                "<string>"
              ]
            }
          ],
          "subtitles": [
            {
              "format": "srt",
              "subtitles": "<string>"
            }
          ],
          "utterances": [
            {
              "language": "en",
              "start": 123,
              "end": 123,
              "confidence": 123,
              "channel": 1,
              "speaker": 1,
              "words": [
                {
                  "word": "<string>",
                  "start": 123,
                  "end": 123,
                  "confidence": 123
                }
              ],
              "text": "<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"
              ],
              "sentences": [
                {
                  "success": true,
                  "is_empty": true,
                  "exec_time": 123,
                  "error": {
                    "status_code": 500,
                    "exception": "<string>",
                    "message": "<string>"
                  },
                  "results": [
                    "<string>"
                  ]
                }
              ],
              "subtitles": [
                {
                  "format": "srt",
                  "subtitles": "<string>"
                }
              ],
              "utterances": [
                {
                  "language": "en",
                  "start": 123,
                  "end": 123,
                  "confidence": 123,
                  "channel": 1,
                  "speaker": 1,
                  "words": [
                    {
                      "word": "<string>",
                      "start": 123,
                      "end": 123,
                      "confidence": 123
                    }
                  ],
                  "text": "<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>"
          },
          "entity": "<string>"
        },
        "name_consistency": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "custom_spelling": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": "<string>"
        },
        "speaker_reidentification": {
          "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>"
          ]
        },
        "chapters": {
          "success": true,
          "is_empty": true,
          "exec_time": 123,
          "error": {
            "status_code": 500,
            "exception": "<string>",
            "message": "<string>"
          },
          "results": {}
        }
      }
    }
  ]
}

Authorizations

x-gladia-key
string
header
required

Your personal Gladia API key

Query Parameters

offset
integer
default:
0

The starting point for pagination. A value of 0 starts from the first item.

Required range: x >= 0
limit
integer
default:
20

The maximum number of items to return. Useful for pagination and controlling data payload size.

Required range: x >= 1
date
string

Filter items relevant to a specific date in ISO format (YYYY-MM-DD).

before_date
string

Include items that occurred before the specified date in ISO format.

after_date
string

Filter for items after the specified date. Use with before_date for a range. Date in ISO format.

status
enum<string>[]

Filter the list based on item status. Accepts multiple values from the predefined list.

Available options:
queued,
processing,
done,
error

Response

200
application/json
A list of live jobs matching the parameters.
first
string
required

URL to fetch the first page

current
string
required

URL to fetch the current page

next
string | null
required

URL to fetch the next page

items
object[]
required

List of live transcriptions