# Obtener la configuración de identidad

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

Devuelve la configuración de nombre de usuario del entorno (un recurso por entorno). Si la configuración nunca se escribió, se devuelven los valores predeterminados de la tabla (`username_identifier: off`, 3 a 64 caracteres, lista reservada vacía) con `ETag: "0"` y `updated_at: null`. El encabezado de respuesta `ETag` lleva la versión a enviar como `If-Match` en `PATCH`.

`verification_policy` (`before_sign_in` de forma predeterminada) y `unverified_account_ttl_days` (7 de forma predeterminada) controlan la limpieza de cuentas no verificadas; consulte [Actualizar la configuración de identidad](/docs/api/management/identity-settings/update).

## Solicitud

Esta operación no recibe campos de ruta, consulta ni cuerpo. El entorno proviene de la credencial.

## Respuesta

`200 OK` con la configuración y el encabezado `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"
}
```

## Errores

| HTTP | código | Cuándo |
|---|---|---|
| 401 | `unauthenticated` | La credencial falta, es inválida o ha sido revocada. |
| 403 | `insufficient_permissions` | La credencial carece del permiso requerido. |
| 429 | `rate_limited` | Se superó el límite de velocidad; reintente después del período `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente después del período `Retry-After`. |

## Ejemplo

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