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).

{
  "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

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 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.