Listar direcciones de correo electrónico

GET /fapi/v1/me/emails · llamado desde el host de inicio de sesión del entorno

Devuelve las direcciones de correo electrónico del usuario autenticado, primero la principal y después las demás por fecha de incorporación. Un usuario tiene como máximo 10 direcciones, incluida la principal. Requiere la cookie __Host-idp_session del usuario autenticado; si la cookie falta, ha caducado o ha sido revocada, devuelve 401 unauthenticated. Una aplicación propia en otro origen puede enviar en su lugar su token de acceso a la API frontal (Authorization: DPoP <token> con una prueba DPoP; consulte Token de acceso a la API frontal).

Solicitud

Encabezados:

Encabezado	Obligatorio	Descripción
`Idp-Client`	sí	Identificador del SDK.
`Origin`	sí	Debe ser exactamente `https://<sign-in host>`.

Sin cuerpo.

Respuesta

200 OK:

Campo	Tipo	Descripción
`data[].id`	string	Identificador de la dirección de correo electrónico (UUID en minúsculas).
`data[].email`	string	La dirección.
`data[].verified`	boolean	Indica si el usuario ha demostrado que es propietario de la dirección.
`data[].primary`	boolean	Indica si es la dirección principal.
`data[].created_at`	string	Momento en que se añadió la dirección (RFC 3339, UTC).

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

Errores

Estado	Código	Cuándo
401	`unauthenticated`	No hay una cookie de sesión válida.
403	`origin_not_allowed`	`Origin` falta o es incorrecto.

Ejemplo

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

Datos personales

Este endpoint contiene datos personales: perfil del usuario final. Datos personales en las API de KeenAuth describe qué se almacena, 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.