---
title: "List sessions"
method: GET
path: "/session-storage/v2/sessions"
tags: ["Sessions v2"]
---

# List sessions

`GET /session-storage/v2/sessions`

## Request

- Base URL: `https://api.palabra.ai`
- URL: `https://api.palabra.ai/session-storage/v2/sessions`
- Auth: API key in header `Authorization`

Returns sessions issued by your account, newest first.
Sessions stay listed for three months after creation, whatever their status.
Filter by your own `client_reference_id` to see everything issued for one customer or
device.
Responses never include `token`.

## Query parameters

- `client_reference_id` string
- `status` 'pending' | 'active' | 'idle' | 'used' | 'expired' | 'revoked': - `pending`: issued, no stream opened yet, connect window still open - `active`: at least one stream is running - `idle`: reusable token that has been used before, no stream running, connect window still open - `used`: single-use token whose stream has finished; cannot be used again - `expired`: connect window has passed and no stream is running - `revoked`: revoked by you
- `created_from` string, date-time
- `created_to` string, date-time
- `page_size` integer
- `page_token` string

## Response `200`

Page of sessions.

- V2SessionListResponse
  - `ok` true, required
  - `data` object, required
    - `sessions` V2Session[], required
      - `id` string, required: Session identifier. Use it to inspect, revoke and report on the session.
      - `token` string: Credential the end user connects with. Returned by `POST /v2/sessions` and `GET /v2/sessions/{id}` only.
      - `intent` 's2s' | 'stt' | 'tts', required: Product the session token is valid for: - `s2s`: speech-to-speech translation - `stt`: speech-to-text - `tts`: text-to-speech A token presented to a different product is refused.
      - `connection_type` 'ws' | 'webrtc', required: Transport the end user will connect with. `webrtc` is available for `s2s` only. A token issued for one transport cannot be used with the other.
      - `single_use` boolean, required: `true` if the token opens only one stream in its lifetime.
      - `client_reference_id` string: Your identifier from the create request.
      - `status` 'pending' | 'active' | 'idle' | 'used' | 'expired' | 'revoked', required: - `pending`: issued, no stream opened yet, connect window still open - `active`: at least one stream is running - `idle`: reusable token that has been used before, no stream running, connect window still open - `used`: single-use token whose stream has finished; cannot be used again - `expired`: connect window has passed and no stream is running - `revoked`: revoked by you
      - `created_at` string, date-time, required: When the session was created.
      - `connect_by` string, date-time, required: Moment after which the token can no longer open a new stream.
      - `max_session_duration_seconds` integer: Duration cap applied to each stream, if one was set.
      - `first_connected_at` string, date-time, nullable: When the first stream was opened with this token, or `null` if none yet.
      - `active_stream_count` integer, required: Number of streams running with this token.
      - `webrtc` V2WebRtcDetails: Present for `connection_type: webrtc` only.
        - `url` string, required: WebRTC endpoint the publisher and listeners connect to.
        - `room_name` string, required: Room the session runs in.
        - `subscriber_keys` string[]: Listener tokens, one per requested subscriber. Returned on creation only.
    - `next_page_token` string, nullable: Token of the next page, or `null` on the last page.

## Other responses

- `401` (unresolved $ref)
- `422` (unresolved $ref)
- `500` (unresolved $ref)

## Changes

- **2026-11-03** `d4a64c9469d4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/palabra/apis/palabra-api/changes/session-storage/v2/sessions/get.md)

---

[API](https://skmtc.dev/palabra/apis/palabra-api.md) - [All operations](https://skmtc.dev/palabra/apis/palabra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/palabra/apis/palabra-api/revisions/d4a64c9469d4?raw)