Get the defaults

GET /v2/live/defaults

The value each option gets when the init body omits it.

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

Example

curl

curl https://eu1.api.gladia.io/v2/live/defaults \
  -H "x-gladia-key: $GLADIA_API_KEY"

Python

import os

import requests

API_URL = os.environ.get("GLADIA_API_URL", "https://eu1.api.gladia.io")
response = requests.get(
    f"{API_URL}/v2/live/defaults",
    headers={"x-gladia-key": os.environ["GLADIA_API_KEY"]},
    timeout=10,
)
response.raise_for_status()
print(response.json())

JavaScript

const API_URL = process.env.GLADIA_API_URL ?? "https://eu1.api.gladia.io";
const response = await fetch(`${API_URL}/v2/live/defaults`, {
  headers: {
    "x-gladia-key": process.env.GLADIA_API_KEY,
    "content-type": "application/json",
  },
});
if (!response.ok) {
  throw new Error(`${response.status} ${await response.text()}`);
}
console.log(await response.json());

Try it

API key (kept in this tab only)

Send GET /v2/live/defaults

Responses

200 The defaults in force.

• endpointing number required

  Silence, in seconds, that ends an utterance.

• maximum_duration_without_endpointing number required

  Longest utterance, in seconds, before a final is forced; null: no limit.

• end_of_turn object required

  The end-of-turn options a session starts from.

  6 fields

  • threshold number required

    End-of-turn probability above which the turn ends.

  • silence_ms integer required

    Silence, in milliseconds, before a turn is evaluated.

  • stop_s number required

    Silence, in seconds, that ends the turn whatever the probability.

  • reeval_ms integer required

    Interval, in milliseconds, between two evaluations of the same silence.

  • window_s number required

    Audio, in seconds, the evaluation reads before the silence.

  • speech_dbfs number required

    Level, in dBFS, under which audio counts as silence.

• turn_router object required

  The number hold a session gets when the model serving it supports it.

  3 fields

  • hold boolean required

    An utterance stays open while a number, an amount or an address is still being dictated.

  • emit boolean required

    Turn verdicts sent as messages.

  • route_numerals boolean required

    Number words routed through the hold.

Example

{
  "endpointing": 0.64,
  "maximum_duration_without_endpointing": 0.5,
  "end_of_turn": {
    "threshold": 0.5,
    "silence_ms": 0,
    "stop_s": 0.5,
    "reeval_ms": 0,
    "window_s": 0.5,
    "speech_dbfs": 0.5
  },
  "turn_router": {
    "hold": false,
    "emit": false,
    "route_numerals": false
  }
}

401 No API key, or an unknown one.

Error body

{
  "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).

Error body

{
  "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"
}