Buscar sessão

Busque uma sessão do Clowk pelo session_id com GET /api/v1/sessions/:id, com provider, endereço IP, horários de login e status de revogação.

GET /api/v1/sessions/:id

Busca uma sessão pelo session_id (clk_session_UUID). Retorna só sessões da instância ligada à sua secret key.

Requisição

curl https://myapp.clowk.dev/api/v1/sessions/clk_session_a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "X-Clowk-Secret-Key: sk_live_..."

Headers

HeaderObrigatórioDescrição
X-Clowk-Secret-KeySimA secret key da sua instância

Parâmetros de caminho

ParâmetroTipoDescrição
idstringO valor de session_id (formato: clk_session_UUID)

Resposta

200 — Sessão encontrada

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "resource": "session",
  "data": {
    "session_id": "clk_session_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "provider": "google",
    "name": "Jane Doe",
    "email": "[email protected]",
    "ip_address": "203.0.113.42",
    "geo_data": {},
    "logged_in_at": "2026-03-20T10:30:00Z",
    "last_signin_at": "2026-03-20T10:30:00Z",
    "revoked_at": null,
    "active": true
  }
}

401 — Não autorizado

{ "error": "Unauthorized" }

404 — Não encontrada

{ "error": "Session not found" }

Nesta página