Elenco degli indirizzi email di un utente

GET /v1/users/{user_id}/emails · autorizzazione users:read

Elenca tutti gli indirizzi email dell'utente in un'unica pagina: prima l'indirizzo principale, poi gli altri in ordine di creazione. Un utente ha al massimo 10 indirizzi (incluso quello principale), quindi l'elenco non ha limit, after, before o order, e list_metadata ha sempre valore null. id è l'UUID interno della riga dell'email, usato dagli altri endpoint email.

Richiesta

Parametro In Obbligatorio Descrizione
user_id path sì ID utente, con prefisso usr_.

La richiesta non prevede un corpo (sono accettati un corpo vuoto o {}).

Risposta

200 OK. Senza l'autorizzazione users:read_pii l'indirizzo viene mascherato (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
  }
}

Errori

Ogni errore è un corpo application/problem+json con un code stabile.

HTTP code Quando
404 not_found L'utente non esiste in questo ambiente, è in fase di eliminazione, oppure l'ID è malformato.
401 unauthenticated La chiave API manca, non è valida o è stata revocata.
403 insufficient_permissions La chiave non ha l'autorizzazione users:read.
429 rate_limited È stato superato il limite di richieste; rispetta Retry-After.
503 service_unavailable Una dipendenza non è temporaneamente disponibile; riprova più tardi.

Esempio

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

Dati personali

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