# Ottenere le impostazioni di identità

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

Restituisce le impostazioni del nome utente dell'ambiente (una risorsa per ambiente). Se le impostazioni non sono mai state scritte, vengono restituiti i valori predefiniti della tabella (`username_identifier: off`, 3-64 caratteri, elenco riservato vuoto) con `ETag: "0"` e `updated_at: null`. L'header di risposta `ETag` contiene la versione da inviare come `If-Match` su `PATCH`.

`verification_policy` (predefinito `before_sign_in`) e `unverified_account_ttl_days` (predefinito 7) controllano la pulizia degli account non verificati; vedere [Aggiornare le impostazioni di identità](/docs/api/management/identity-settings/update).

## Richiesta

Questa operazione non accetta campi di percorso, query o corpo. L'ambiente deriva dalla credenziale.

## Risposta

`200 OK` con le impostazioni e l'header `ETag`.

```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"
}
```

## Errori

| HTTP | code | Quando |
|---|---|---|
| 401 | `unauthenticated` | La credenziale è mancante, non valida o revocata. |
| 403 | `insufficient_permissions` | La credenziale non ha il permesso richiesto. |
| 429 | `rate_limited` | Il limite di velocità è stato superato; riprova dopo il periodo `Retry-After`. |
| 503 | `service_unavailable` | Una dipendenza è temporaneamente non disponibile; riprova dopo il periodo `Retry-After`. |

## Esempio

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