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

# Listar sessões

> Lista as sessões de login ativas do usuário autenticado.

### Resposta

**response** `array`

Um array de sessões ativas.

**Mostrar objeto**

**id** `string`

O ID da sessão.

**user\_id** `string`

O ID do usuário dono da sessão.

**provider** `string`

Como a sessão foi criada (por exemplo, `email`, `google`, `github`).

**ip\_address** `string | null`

O endereço IP de onde a sessão foi criada, se conhecido.

**location** `string | null`

Uma localização aproximada derivada do IP, se conhecida.

**device** `string | null`

Uma descrição do dispositivo ou navegador, se conhecida.

**expires\_at** `string`

Quando a sessão expira.

**created\_at** `string`

Quando a sessão foi criada.

**updated\_at** `string`

Quando a sessão foi usada pela última vez.

**is\_current** `boolean`

Se esta é a sessão vinculada à credencial que faz a requisição atual.

```json Response theme={null}
{
  "response": [
    {
      "id": "session-abc123",
      "user_id": "user-123456789012345678",
      "provider": "email",
      "ip_address": "203.0.113.10",
      "location": "Fortaleza, BR",
      "device": "Chrome on macOS",
      "expires_at": "2026-10-20T15:00:00.000Z",
      "created_at": "2026-09-20T15:00:00.000Z",
      "updated_at": "2026-09-21T09:00:00.000Z",
      "is_current": true
    }
  ]
}
```

### Respostas de erro

**code** `string`

O código de erro que indica o motivo da falha. Valores possíveis:

* `AUTH_TOKEN_MISSING`, `API_KEY_INVALID`, `SESSION_REVOKED`: O cabeçalho `Authorization` está ausente, a chave de API é inválida ou a sessão do painel foi revogada (`401`).
* `API_KEY_IP_DENIED`, `API_KEY_SCOPE_DENIED`: A chave de API é usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (`403`).
* `USER_NOT_FOUND`: O usuário autenticado não foi encontrado.
* `INTERNAL_SERVER_ERROR`: Ocorreu um erro inesperado no servidor.

```json Error Response (401) theme={null}
{
  "code": "AUTH_TOKEN_MISSING"
}
```

> [!NOTE]
>
> Revogar uma sessão é uma ação exclusiva do painel — ela não é acessível com uma chave de API.


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