# E-Mail-Adressen eines Benutzers auflisten

`GET /v1/users/{user_id}/emails` · Berechtigung `users:read`

Listet alle E-Mail-Adressen des Benutzers auf einer Seite auf: zuerst die primäre Adresse, danach nach Erstellungszeitpunkt. Ein Benutzer hat höchstens 10 Adressen (einschließlich der primären), daher gibt es keine `limit`-, `after`-, `before`- oder `order`-Parameter, und `list_metadata` ist immer mit `null` belegt. `id` ist die interne UUID des E-Mail-Eintrags und wird von den anderen E-Mail-Endpunkten verwendet.

## Anfrage

| Parameter | In | Erforderlich | Beschreibung |
|---|---|---|---|
| `user_id` | path | ja | Benutzer-ID mit Präfix `usr_`. |

Die Anfrage enthält keinen Body (ein leerer Body oder `{}` wird akzeptiert).

## Antwort

`200 OK`. Ohne die Berechtigung `users:read_pii` wird die Adresse maskiert (`a***@e***.com`).

```json
{
  "data": [
    {
      "id": "0191f0a0-3333-7444-8555-666666666661",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-01-15T09:30:00Z"
    },
    {
      "id": "0191f0a0-3333-7444-8555-666666666666",
      "email": "ada.work@example.com",
      "verified": false,
      "primary": false,
      "created_at": "2026-02-01T08:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## Fehler

Jeder Fehler ist ein `application/problem+json`-Body mit einem stabilen `code`.

| HTTP | `code` | Wann |
|---|---|---|
| 404 | `not_found` | Der Benutzer existiert in dieser Umgebung nicht, wird gerade gelöscht, oder die ID ist fehlerhaft. |
| 401 | `unauthenticated` | Der API-Schlüssel fehlt, ist ungültig oder wurde widerrufen. |
| 403 | `insufficient_permissions` | Der Schlüssel hat nicht die Berechtigung `users:read`. |
| 429 | `rate_limited` | Das Ratenlimit wurde überschritten; beachten Sie `Retry-After`. |
| 503 | `service_unavailable` | Eine Abhängigkeit ist vorübergehend nicht verfügbar; versuchen Sie es später erneut. |

## Beispiel

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

## Personenbezogene Daten

Dieser Endpunkt verarbeitet personenbezogene Daten: Profil des Endbenutzers. [Personenbezogene Daten in den KeenAuth-APIs](/docs/policies/personal-data) beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Übermitteln Sie keine besonderen Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung) in irgendeinem Feld.