# Eine Sitzung abrufen

`GET /v1/sessions/{session_id}` · Berechtigung `sessions:read`

Gibt eine Sitzung in jedem Status zurück (`active`, `expired`, `revoked`). Die vollständige IP-Adresse wird angezeigt, und der Zugriff wird im Verwaltungs-Audit-Log protokolliert. Cookies, Tokens und Geräte-Fingerprints werden nie zurückgegeben.

## Anfrage

| Parameter | In | Pflicht | Beschreibung |
|---|---|---|---|
| `session_id` | path | ja | Sitzungs-ID, mit `ses_` beginnend. |

## Antwort

`200 OK`. Leere Felder sind `null`.

```json
{
  "id": "ses_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "user_id": "usr_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "status": "revoked",
  "login_host": "login.example.com",
  "auth_time": "2026-02-01T08:00:00Z",
  "acr": "1fa",
  "amr": ["pwd"],
  "created_at": "2026-02-01T08:00:00Z",
  "last_seen_at": "2026-02-01T09:15:00Z",
  "idle_expires_at": "2026-02-08T09:15:00Z",
  "absolute_expires_at": "2026-03-03T08:00:00Z",
  "org_id": "org_0a1b2c3d4e5f6g7h8j9k0m1n2p",
  "ip_address": "203.0.113.10",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0)",
  "revoked_at": "2026-02-01T10:00:00Z",
  "revoke_reason": "admin"
}
```

`revoke_reason` ist nur für `revoked`-Sitzungen gesetzt, zum Beispiel `admin`, `user_logout`, `idp_logout` oder `refresh_reuse`.

## Fehler

Jeder Fehler ist ein `application/problem+json`-Body mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 404 | `not_found` | Die Sitzung existiert in dieser Umgebung nicht (oder die ID ist fehlerhaft). |
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
| 403 | `insufficient_permissions` | Dem Schlüssel fehlt die Berechtigung `sessions:read`. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage später. |

## Beispiel

```bash
curl https://api.eu.keenauth.com/v1/sessions/ses_0a1b2c3d4e5f6g7h8j9k0m1n2p \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

CLI: `keenauth sessions get ses_0a1b2c3d4e5f6g7h8j9k0m1n2p`

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Sitzungen. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).