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

# List Sessions

> List all active sessions

# List Sessions

Retrieve all active sessions for the authenticated account.

<ParamField query="status" type="string">
  Filter by status: `launching`, `ready`, `active`, `idle`.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Maximum number of results (1-100).
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for pagination (from previous response's `nextCursor`).
</ParamField>

## Request

```bash theme={null}
curl "https://api.meshbrow.dev/v1/sessions?status=active&limit=10" \
  -H "Authorization: Bearer mb_live_..."
```

## Response

```json 200 theme={null}
{
  "items": [
    {
      "id": "ses_k8m2n4p6",
      "status": "active",
      "proxy": { "type": "residential", "country": "US" },
      "createdAt": "2026-10-27T14:00:00Z",
      "expiresAt": "2026-10-27T14:30:00Z"
    },
    {
      "id": "ses_j7l1m3o5",
      "status": "active",
      "proxy": { "type": "isp", "country": "GB" },
      "createdAt": "2026-10-27T13:45:00Z",
      "expiresAt": "2026-10-27T14:45:00Z"
    }
  ],
  "hasMore": false,
  "total": 2
}
```