# Die Altersrichtlinie abrufen

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

Gibt die Altersrichtlinie der Umgebung zurück (eine Ressource pro Umgebung; keine Überschreibung pro Anwendung). Wurde die Richtlinie nie geschrieben, werden die Tabellenstandards (`mode: off`, `min_age: 16`, leere Ländertabelle) mit `ETag: "0"` und `updated_at: null` zurückgegeben. Der `ETag`-Antwortheader enthält die Version, die bei `PUT` als `If-Match` zu senden ist. Verwendet die Berechtigungen der Identitätseinstellungen, da die Altersrichtlinie zu ihnen gehört.

## Anfrage

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

## Antwort

`200 OK` mit der Richtlinie und dem `ETag`-Header.

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

## 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/age-policy \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```