# Listar las direcciones de correo electrónico de un usuario

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

Lista todas las direcciones de correo electrónico del usuario en una sola página: primero la dirección principal y después el resto, por fecha de creación. Un usuario tiene como máximo 10 direcciones (incluida la principal), por lo que la lista no tiene `limit`, `after`, `before` ni `order`, y `list_metadata` siempre tiene el valor `null`. `id` es el UUID interno de la fila de correo electrónico, que usan los demás endpoints de correo electrónico.

## Solicitud

| Parámetro | En | Obligatorio | Descripción |
|---|---|---|---|
| `user_id` | path | sí | ID del usuario, con el prefijo `usr_`. |

La solicitud no lleva cuerpo (se acepta un cuerpo vacío o `{}`).

## Respuesta

`200 OK`. Sin el permiso `users:read_pii`, la dirección aparece enmascarada (`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
  }
}
```

## Errores

Cada error es un cuerpo `application/problem+json` con un `code` estable.

| HTTP | `code` | Cuándo |
|---|---|---|
| 404 | `not_found` | El usuario no existe en este entorno, se está eliminando, o el ID está mal formado. |
| 401 | `unauthenticated` | La clave de API falta, no es válida o fue revocada. |
| 403 | `insufficient_permissions` | La clave no tiene el permiso `users:read`. |
| 429 | `rate_limited` | Se superó el límite de frecuencia; respete `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; vuelva a intentarlo más tarde. |

## Ejemplo

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

## Datos personales

Este endpoint contiene datos personales: perfil del usuario final. [Datos personales en las API de KeenAuth](/docs/policies/personal-data) describe qué se almacena, durante cuánto tiempo se conserva y cómo se elimina. No envíe categorías especiales de datos personales (salud, datos biométricos, religión, opiniones políticas, orientación sexual) en ningún campo.