> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hitl.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# List Sessions

> Return sessions owned by the API key's user, most recent first.

## Authentication

**Authorization** `string` *required*

Bearer API key.

## Query

**status** `string`

Filter: `active` | `paused` | `completed` | `abandoned`.

**agent\_type** `string`

Filter: `claude` | `codex`.

**limit** `integer` (default: 50)

Max 100.

**offset** `integer` (default: 0)

## Response

**data.sessions** `array`

Array of session objects.

**data.count** `integer`

Number of sessions returned.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.