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

# Listar Sessões

> Lista todas as sessões do tenant

Retorna uma lista paginada de todas as sessões do tenant.

## Query Parameters

<ParamField query="page" default="1" type="integer">
  Número da página.
</ParamField>

<ParamField query="limit" default="10" type="integer">
  Quantidade de itens por página (máximo 100).
</ParamField>

<ParamField query="status" type="string">
  Filtrar por status da sessão.

  **Valores:** `disconnected`, `qr`, `connecting`, `connected`
</ParamField>

## Resposta

<ResponseField name="data" type="array">
  Lista de sessões.

  <Expandable title="Objeto Session">
    <ResponseField name="id" type="string">
      ID único da sessão.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome da sessão.
    </ResponseField>

    <ResponseField name="status" type="string">
      Status atual.
    </ResponseField>

    <ResponseField name="phone" type="string">
      Número conectado (se conectado).
    </ResponseField>

    <ResponseField name="allowGroup" type="boolean">
      Se grupos estão habilitados.
    </ResponseField>

    <ResponseField name="hasWebhook" type="boolean">
      Se tem webhook configurado.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Data de criação.
    </ResponseField>

    <ResponseField name="connectedAt" type="string">
      Data da última conexão.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Metadados de paginação.

  <Expandable title="Metadados">
    <ResponseField name="total" type="integer">
      Total de itens.
    </ResponseField>

    <ResponseField name="page" type="integer">
      Página atual.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      Itens por página.
    </ResponseField>

    <ResponseField name="totalPages" type="integer">
      Total de páginas.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET "https://api.oxenty.api.br/api/sessions?page=1&limit=10&status=connected" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  const sessions = await client.sessions.list({
    page: 1,
    limit: 10,
    status: 'connected',
  });
  ```

  ```python Python theme={"system"}
  sessions = client.sessions.list(
      page=1,
      limit=10,
      status='connected'
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "data": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "atendimento-principal",
        "status": "connected",
        "phone": "5511999999999",
        "allowGroup": true,
        "hasWebhook": true,
        "createdAt": "2024-01-15T10:00:00.000Z",
        "connectedAt": "2024-01-15T10:05:00.000Z"
      },
      {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "suporte",
        "status": "connected",
        "phone": "5511888888888",
        "allowGroup": false,
        "hasWebhook": false,
        "createdAt": "2024-01-14T08:00:00.000Z",
        "connectedAt": "2024-01-14T08:10:00.000Z"
      }
    ],
    "meta": {
      "total": 2,
      "page": 1,
      "limit": 10,
      "totalPages": 1
    }
  }
  ```
</ResponseExample>