Skip to content

History

Every session of your account stays in its history for your retention, with its options and transcript. The same history is in Gladia Workspace, under Transcriptions.

GET /v2/live returns your sessions, newest first:

Terminal window
curl -G https://eu1.api.gladia.io/v2/live -H "x-gladia-key: $GLADIA_API_KEY" \
-d limit=20 -d status=done -d after_date=2026-10-01T00:00:00Z
parameter what it does
limit Sessions per page, 1 to 100 (20 by default).
status done, error, processing; repeat it for several.
date, after_date, before_date A day, or a time range (ISO 8601).
custom_metadata Sessions whose metadata has these values.

Follow next to get the following page, until it is null: it carries a cursor that keeps deep pages fast. offset works too, up to 1,000.

GET /v2/live/{id} returns one session: its status, its request_params, its custom_metadata and, once done, its result: every final utterance, the full transcript, the translations.

DELETE /v2/live/{id} deletes a session that has ended, its transcript and its recording, for good (202). A running session cannot be deleted (403).