Elenca gli indirizzi email

GET /fapi/v1/me/emails · chiamato dall'host di accesso dell'ambiente

Restituisce gli indirizzi email dell'utente autenticato, prima quello principale, poi in ordine di data di aggiunta. Un utente può avere al massimo 10 indirizzi, incluso quello principale. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso Front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso Front API).

Richiesta

Intestazioni:

Intestazione Obbligatoria Descrizione
Idp-Client sì Identificatore dell'SDK.
Origin sì Deve essere esattamente https://<sign-in host>.

Nessun corpo.

Risposta

200 OK:

Campo Tipo Descrizione
data[].id string Identificatore dell'indirizzo email (UUID in minuscolo).
data[].email string L'indirizzo.
data[].verified boolean Indica se l'utente ha dimostrato di possedere l'indirizzo.
data[].primary boolean Indica se questo è l'indirizzo principale.
data[].created_at string Quando l'indirizzo è stato aggiunto (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"
    }
  ]
}

Errori

Stato Codice Quando
401 unauthenticated Cookie di sessione assente o non valido.
403 origin_not_allowed Origin manca o è errato.

Esempio

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

Dati personali

Questo endpoint contiene dati personali: profilo dell'utente finale. Dati personali nelle API KeenAuth descrive cosa viene archiviato, per quanto tempo viene conservato e come viene eliminato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.