# Kullanıcının e-posta adreslerini listeleme

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

Kullanıcının tüm e-posta adreslerini tek bir sayfada listeler: önce birincil adres, ardından oluşturulma zamanına göre. Bir kullanıcının en fazla 10 adresi olabilir (birincil adres dahil), bu nedenle listenin `limit`, `after`, `before` ya da `order` parametresi yoktur ve `list_metadata` her zaman `null` değerlidir. `id`, e-posta kaydının iç UUID değeridir ve diğer e-posta uç noktaları tarafından kullanılır.

## İstek

| Parametre | Konum | Zorunlu | Açıklama |
|---|---|---|---|
| `user_id` | path | evet | Kullanıcı kimliği, `usr_` önekiyle. |

İstek gövde almaz (boş gövde ya da `{}` kabul edilir).

## Yanıt

`200 OK`. `users:read_pii` izni olmadan adres maskelenir (`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
  }
}
```

## Hatalar

Her hata, kararlı bir `code` içeren bir `application/problem+json` gövdesidir.

| HTTP | `code` | Ne zaman |
|---|---|---|
| 404 | `not_found` | Kullanıcı bu ortamda yok, siliniyor ya da kimlik hatalı biçimlendirilmiş. |
| 401 | `unauthenticated` | API anahtarı eksik, geçersiz veya iptal edilmiş. |
| 403 | `insufficient_permissions` | Anahtarda `users:read` izni yok. |
| 429 | `rate_limited` | Hız sınırı aşıldı; `Retry-After` değerine uyun. |
| 503 | `service_unavailable` | Bir bağımlılık geçici olarak kullanılamıyor; daha sonra yeniden deneyin. |

## Örnek

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

## Kişisel veriler

Bu uç nokta kişisel veri içerir: son kullanıcı profili. [KeenAuth API'lerinde kişisel veriler](/docs/policies/personal-data) saklanan verileri, ne kadar süreyle tutulduklarını ve nasıl silindiklerini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.