# Hole die Identitätseinstellungen

`GET /v1/identity-settings` · Berechtigung `identity-settings:read`

Gibt die Benutzernamen-Einstellungen der Umgebung zurück (eine Ressource pro Umgebung). Wurden die Einstellungen nie geschrieben, werden die Tabellenstandards zurückgegeben (`username_identifier: off`, 3–64 Zeichen, leere Liste reservierter Namen) mit `ETag: "0"` und `updated_at: null`. Der `ETag`-Response-Header trägt die Version zum Senden als `If-Match` auf `PATCH`.

`verification_policy` (Standard `before_sign_in`) und `unverified_account_ttl_days` (Standard 7) steuern die Bereinigung unbestätigter Konten; siehe [Aktualisiere die Identitätseinstellungen](/docs/api/management/identity-settings/update).

## Anfrage

Diese Operation nimmt keine Pfad-, Query- oder Body-Felder entgegen. Die Umgebung stammt aus den Anmeldedaten.

## Antwort

`200 OK` mit den Einstellungen und dem `ETag`-Header.

```json
{
  "username_identifier": "optional",
  "username_min_length": 3,
  "username_max_length": 32,
  "reserved_usernames": ["admin", "root", "support"],
  "verification_policy": "before_sign_in",
  "unverified_account_ttl_days": 7,
  "updated_at": "2026-10-05T09:30:00.123456Z"
}
```

## Fehler

| HTTP | Code | Wann |
|---|---|---|
| 401 | `unauthenticated` | Die Anmeldedaten fehlen, sind ungültig oder wurden widerrufen. |
| 403 | `insufficient_permissions` | Die Anmeldedaten haben nicht die erforderliche Berechtigung. |
| 429 | `rate_limited` | Die Rate-Grenze wurde überschritten; Wiederhole nach dem `Retry-After`-Zeitraum. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; Wiederhole nach dem `Retry-After`-Zeitraum. |

## Beispiel

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