---
title: "List Sessions"
method: GET
path: "/v1/sessions"
tags: ["sessions"]
---

# List Sessions

`GET /v1/sessions`

## Request

- Base URL: `https://api.dotwave.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dotwave.ai/v1/sessions`
- Auth: none declared

## Query parameters

- `from` integer, nullable
- `to` integer, nullable
- `status` string, nullable
- `cursor` string, nullable

## Headers

- `authorization` string, nullable: `Bearer wk_…`: the project's API key (`Token` is an alias of `Bearer`). Create API keys in the console. New accounts start with $10 of credit; no card required.
- `x-api-key` string, nullable: The same API key, in place of the Authorization header.

## Response `200`

Successful Response

- SessionListResponse
  - `data` SessionResponse[], required
    - `admitted_at` integer, nullable, required
    - `close_reason` string, nullable, required
    - `closed_at` integer, nullable, required
    - `configuration` object, required
    - `connected_at` integer, nullable, required
    - `created_at` integer, required
    - `expires_at` integer, required
    - `id` string, required
    - `metadata` object, required
    - `model` string, required
    - `object` string, required
    - `pool` string, required
    - `project_id` string, required
    - `region` string, required
    - `status` string, required
    - `usage` object, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `object` 'list', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/dotwave/apis/wave-live-api.md) - [All operations](https://skmtc.dev/dotwave/apis/wave-live-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dotwave/apis/wave-live-api/revisions/57e80b62c850?raw)