
# Ottieni la policy sull'età

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

Restituisce la policy sull'età dell'ambiente (una risorsa per ambiente; nessuna sostituzione per applicazione). Se la policy non è mai stata scritta, vengono restituiti i valori predefiniti (`mode: off`, `min_age: 16`, tabella dei paesi vuota) con `ETag: "0"` e `updated_at: null`. L'header di risposta `ETag` contiene la versione da inviare come `If-Match` nel `PUT`. Usa i permessi delle impostazioni di identità, di cui la policy sull'età fa parte.

## Richiesta

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

## Risposta

`200 OK` con la policy e l'header `ETag`.

```json
{
  "mode": "attestation",
  "min_age": 16,
  "country_min_age": {"DE": 16, "FR": 15, "IT": 14},
  "country_source": "ip",
  "under_age_action": "block",
  "parental_consent_below": null,
  "pending_consent_action": "block_sign_in",
  "store_birthdate": false,
  "applies_to": "self_signup",
  "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/age-policy \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
