> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Modello dati utente: schema utente del fornitore > Ogni campo di un'entità utente Didit: identità, stato, aggregati delle sessioni KYC, biometria, timestamp di attività e metadati. Prezzi a consumo. Questa pagina documenta ogni campo di un'entità User. I campi si dividono in cinque gruppi: identità, stato, aggregati di sessione, timestamp di attività e metadati. ## Campi di identità | Campo | Tipo | Descrizione | | - | - | - | | `uuid` | UUID | Chiave primaria assegnata da Didit. Stabile e univoca. | | `didit_internal_id` | string | Identificatore interno leggibile (visibile nelle risposte API). | | `vendor_data` | string | Il tuo identificatore per l'utente. Univoco per applicazione. [Scopri di più](https://docs.didit.me/it/entities/vendor-data-linking.md). | | `display_name` | string | Nome alternativo mostrato nella console. Se non impostato, il valore predefinito è `full_name` o `vendor_data`. | | `full_name` | string | Nome legale completo, propagato dal documento d'identità della sessione di Verifica degli utenti (KYC) approvata più recente. | | `date_of_birth` | date (ISO 8601) | Propagata dalla sessione di Verifica degli utenti (KYC) approvata più recente. | | `portrait_image` | URL | URL S3 firmato del selfie tratto dal Rilevamento della vitalità approvato più recente. | > [!NOTE] > > `full_name`, `date_of_birth` e `portrait_image` sono di sola lettura quando derivano da una sessione verificata. Puoi sovrascriverli tramite la console o tramite `PATCH /v3/users/{vendor_data}/`, ma le sovrascritture manuali vengono segnalate nel registro di audit. ## Stato | Campo | Tipo | Valori | Descrizione | | - | - | - | - | | `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | Determina le misure applicate alle sessioni e alle transazioni future. Vedi [ciclo di vita](https://docs.didit.me/it/entities/lifecycle.md). | ## Campi aggregati di sessione Questi campi sono calcolati da Didit e si aggiornano in tempo reale al completamento delle sessioni. | Campo | Tipo | Descrizione | | - | - | - | | `session_count` | int | Numero totale di sessioni create per questo utente | | `approved_count` | int | Sessioni terminate con `APPROVED` | | `declined_count` | int | Sessioni terminate con `DECLINED` | | `in_review_count` | int | Sessioni attualmente `IN_REVIEW` | | `issuing_states[]` | array di codici paese ISO | Paesi di tutti i documenti d'identità verificati nelle sessioni | | `approved_emails[]` | array di stringhe | Email verificate tramite [Verifica email](https://docs.didit.me/it/core-technology/email-verification/overview.md) | | `approved_phones[]` | array di stringhe | Numeri di telefono verificati tramite [Verifica telefonica](https://docs.didit.me/it/core-technology/phone-verification/overview.md) | | `features` | object | Stato più recente di ogni funzionalità in tutte le sessioni | ### La mappa `features` Ogni sessione esegue una o più funzionalità (verifica dell'identità, vitalità, confronto facciale, AML, prova di residenza, NFC, ecc.). La mappa `features` contiene lo stato **più recente** di ogni funzionalità per questo utente: ```json theme={null} { "id_verification": "APPROVED", "liveness": "APPROVED", "face_match": "APPROVED", "aml": "IN_REVIEW", "proof_of_address": "APPROVED", "nfc_verification": "NOT_FINISHED" } ``` Stati delle funzionalità: `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW`, `EXPIRED`, `ABANDONED`, `RESUB_REQUESTED`. Usa la mappa `features` come percorso rapido per stabilire se un utente è completamente verificato in questo momento, senza scorrere tutte le sessioni. ## Timestamp di attività | Campo | Tipo | Aggiornato quando | | - | - | - | | `first_session_at` | timestamp ISO | È stata creata la prima sessione | | `last_session_at` | timestamp ISO | È stata creata o aggiornata la sessione più recente | | `last_activity_at` | timestamp ISO | Qualsiasi modifica: sessione, transazione, stato, profilo, note, tag | | `created_at` | timestamp ISO | È stata creata la riga dell'entità | | `updated_at` | timestamp ISO | La riga dell'entità è stata aggiornata per l'ultima volta | ## Metadati | Campo | Tipo | Descrizione | | - | - | - | | `metadata` | object (JSON) | JSON in formato libero sotto il tuo controllo. Usalo per tag interni, livello, fonte di registrazione, ecc. | | `tags[]` | array | Tag gestiti da console o API per filtrare e raggruppare | I metadati non hanno uno schema: Didit salva qualsiasi valore tu scriva. ## Relazioni (non memorizzate nella riga dell'utente) | Relazione | Come accedervi | | - | - | | Sessioni | `GET /v3/sessions?vendor_data=` | | Transazioni (come richiedente) | `GET /v3/transactions/?vendor_data=` | | Transazioni (come controparte) | Filtra l'elenco delle transazioni per vendor\_data della controparte nella console | | Aziende collegate (amministratore / titolare effettivo) | Visibili nella pagina di dettaglio dell'utente nella console | | Dati biometrici del volto | Console + Lists API | | Voci della blocklist | [Lists API](https://docs.didit.me/it/management-api/lists/overview.md): filtra le voci in base agli identificatori dell'utente | ## Esempio di risposta ```json theme={null} { "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a", "didit_internal_id": "U-2026-00042", "vendor_data": "user-42", "display_name": "Jane Doe", "full_name": "John Doe", "date_of_birth": "1990-01-01", "portrait_image": "https:///...", "status": "ACTIVE", "session_count": 3, "approved_count": 2, "declined_count": 0, "in_review_count": 1, "issuing_states": ["US", "ES"], "approved_emails": ["jane@example.com"], "approved_phones": ["+14155550123"], "features": { "id_verification": "APPROVED", "liveness": "APPROVED", "face_match": "APPROVED", "aml": "IN_REVIEW" }, "first_session_at": "2025-03-01T12:00:00Z", "last_session_at": "2026-04-10T09:00:00Z", "last_activity_at": "2026-04-16T10:00:00Z", "metadata": { "tier": "premium" } } ``` ## Passaggi successivi > [card] [Operazioni](https://docs.didit.me/it/entities/users/operations.md) > > Crea, aggiorna, modifica lo stato, elimina. > [card] [Storico KYC](https://docs.didit.me/it/entities/users/kyc-history.md) > > Recupera tutte le sessioni associate all'utente. > [card] [Riferimento API](https://docs.didit.me/it/management-api/users/get.md) > > Schema di GET /v3/users/{vendor_data}/. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.