# E-Mail-Adressen auflisten

`GET /fapi/v1/me/emails` · wird vom Anmelde-Host der Umgebung aufgerufen

Gibt die E-Mail-Adressen des authentifizierten Benutzers zurück, zuerst die primäre, danach sortiert nach dem Zeitpunkt, zu dem sie hinzugefügt wurden. Ein Benutzer kann höchstens 10 Adressen haben, einschließlich der primären. Erforderlich ist das Cookie `__Host-idp_session` des authentifizierten Benutzers. Fehlt das Cookie, ist es abgelaufen oder widerrufen, wird `401 unauthenticated` zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (`Authorization: DPoP <token>` mit einem DPoP-Proof; siehe [Front-API-Zugriffstoken](/docs/api/fapi/front-api-token)).

## Anfrage

Header:

| Header | Erforderlich | Beschreibung |
| --- | --- | --- |
| `Idp-Client` | ja | SDK-Kennung. |
| `Origin` | ja | Muss genau `https://<sign-in host>` sein. |

Kein Body.

## Antwort

`200 OK`:

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `data[].id` | string | Kennung der E-Mail-Adresse (UUID in Kleinbuchstaben). |
| `data[].email` | string | Die Adresse. |
| `data[].verified` | boolean | Ob der Benutzer nachgewiesen hat, dass ihm die Adresse gehört. |
| `data[].primary` | boolean | Ob es sich um die primäre Adresse handelt. |
| `data[].created_at` | string | Zeitpunkt, zu dem die Adresse hinzugefügt wurde (RFC 3339, UTC). |

```json
{
  "data": [
    {
      "id": "0190a5c4-1b2c-7d3e-8f40-516273849abc",
      "email": "ada@example.com",
      "verified": true,
      "primary": true,
      "created_at": "2026-10-01T09:30:00Z"
    }
  ]
}
```

## Fehler

| Status | Code | Wann |
| --- | --- | --- |
| 401 | `unauthenticated` | Kein gültiges Sitzungs-Cookie. |
| 403 | `origin_not_allowed` | `Origin` fehlt oder ist falsch. |

## Beispiel

```bash
curl https://example.keenauth.app/fapi/v1/me/emails \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -b cookies.txt
```

## 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. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).