# Obtenir les paramètres d'identité

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

Retourne les paramètres de nom d'utilisateur de l'environnement (une ressource par environnement). Si les paramètres n'ont jamais été écrits, les valeurs par défaut de la table sont retournées (`username_identifier: off`, 3 à 64 caractères, liste réservée vide) avec `ETag: "0"` et `updated_at: null`. L'en-tête de réponse `ETag` porte la version à envoyer comme `If-Match` sur `PATCH`.

`verification_policy` (`before_sign_in` par défaut) et `unverified_account_ttl_days` (7 par défaut) pilotent le nettoyage des comptes non vérifiés ; voir [Mettre à jour les paramètres d'identité](/docs/api/management/identity-settings/update).

## Requête

Cette opération n'accepte aucun champ de chemin, de requête ou de corps. L'environnement provient de l'authentification.

## Réponse

`200 OK` avec les paramètres et l'en-tête `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"
}
```

## Erreurs

| HTTP | code | Quand |
|---|---|---|
| 401 | `unauthenticated` | L'authentification est manquante, invalide ou révoquée. |
| 403 | `insufficient_permissions` | L'authentification manque la permission requise. |
| 429 | `rate_limited` | La limite de débit a été dépassée ; réessayez après la période `Retry-After`. |
| 503 | `service_unavailable` | Une dépendance est temporairement indisponible ; réessayez après la période `Retry-After`. |

## Exemple

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