# History

Every session of your account stays in its history for your [retention](/data/retention/), with its options and
transcript. The same history is in Gladia Workspace, under **Transcriptions**.

## List

[`GET /v2/live`](/api-reference/v2/live/list/) returns your sessions, newest first:

```bash
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](/features/custom-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.

## Read

[`GET /v2/live/{id}`](/api-reference/v2/live/get/) 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

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