> ## 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. # Modèle de données utilisateur : schéma fournisseur > Chaque champ d'une entité utilisateur Didit : identité, statut, sessions KYC, biométrie, horodatages et métadonnées. Tarification à l'usage. Cette page documente chaque champ d'une entité User. Les champs sont répartis en cinq groupes : identité, statut, agrégats de session, horodatages d'activité et métadonnées. ## Champs d'identité | Champ | Type | Description | | - | - | - | | `uuid` | UUID | Clé primaire attribuée par Didit. Stable et unique. | | `didit_internal_id` | chaîne | Identifiant interne lisible par un humain (affiché dans les réponses de l'API). | | `vendor_data` | chaîne | Votre identifiant pour l'utilisateur. Unique par application. [En savoir plus](https://docs.didit.me/fr/entities/vendor-data-linking.md). | | `display_name` | chaîne | Nom de remplacement affiché dans la console. Par défaut, `full_name` ou `vendor_data` lorsqu'il n'est pas défini. | | `full_name` | chaîne | Nom légal complet repris du document d'identité de la dernière session de Vérification des utilisateurs (KYC) approuvée. | | `date_of_birth` | date (ISO 8601) | Repris de la dernière session de Vérification des utilisateurs (KYC) approuvée. | | `portrait_image` | URL | URL S3 signée du selfie issu du dernier contrôle de détection du vivant approuvé. | > [!NOTE] > > `full_name`, `date_of_birth` et `portrait_image` sont en lecture seule lorsqu'ils proviennent d'une session vérifiée. Vous pouvez les remplacer depuis la console ou via `PATCH /v3/users/{vendor_data}/`, mais les remplacements manuels sont signalés dans le journal d'audit. ## Statut | Champ | Type | Valeurs | Description | | - | - | - | - | | `status` | énumération | `ACTIVE`, `FLAGGED`, `BLOCKED` | Détermine l'application des règles pour les sessions et transactions à venir. Voir [cycle de vie](https://docs.didit.me/fr/entities/lifecycle.md). | ## Champs d'agrégats de session Ces champs sont calculés par Didit et se mettent à jour en temps réel à mesure que les sessions se terminent. | Champ | Type | Description | | - | - | - | | `session_count` | entier | Nombre total de sessions créées pour cet utilisateur | | `approved_count` | entier | Sessions terminées avec `APPROVED` | | `declined_count` | entier | Sessions terminées avec `DECLINED` | | `in_review_count` | entier | Sessions actuellement `IN_REVIEW` | | `issuing_states[]` | tableau de codes pays ISO | Pays de délivrance de tous les documents d'identité vérifiés dans l'ensemble des sessions | | `approved_emails[]` | tableau de chaînes | E-mails vérifiés via [Vérification de l'e-mail](https://docs.didit.me/fr/core-technology/email-verification/overview.md) | | `approved_phones[]` | tableau de chaînes | Téléphones vérifiés via [Vérification du téléphone](https://docs.didit.me/fr/core-technology/phone-verification/overview.md) | | `features` | objet | Dernier statut de chaque fonctionnalité dans l'ensemble des sessions | ### Le dictionnaire `features` Chaque session exécute une ou plusieurs fonctionnalités (vérification d'identité, détection du vivant, correspondance faciale, AML, POA, NFC, etc.). Le dictionnaire `features` contient le **dernier** statut de chaque fonctionnalité pour cet utilisateur : ```json theme={null} { "id_verification": "APPROVED", "liveness": "APPROVED", "face_match": "APPROVED", "aml": "IN_REVIEW", "proof_of_address": "APPROVED", "nfc_verification": "NOT_FINISHED" } ``` Statuts des fonctionnalités : `NOT_FINISHED`, `APPROVED`, `DECLINED`, `IN_REVIEW`, `EXPIRED`, `ABANDONED`, `RESUB_REQUESTED`. Utilisez le dictionnaire `features` pour répondre rapidement à la question « cet utilisateur est-il entièrement vérifié à cet instant ? » sans parcourir toutes les sessions. ## Horodatages d'activité | Champ | Type | Mis à jour lorsque | | - | - | - | | `first_session_at` | horodatage ISO | La première session a été créée | | `last_session_at` | horodatage ISO | La session la plus récente a été créée ou mise à jour | | `last_activity_at` | horodatage ISO | Toute modification : session, transaction, statut, profil, notes, tags | | `created_at` | horodatage ISO | La ligne de l'entité a été créée | | `updated_at` | horodatage ISO | La ligne de l'entité a été mise à jour pour la dernière fois | ## Métadonnées | Champ | Type | Description | | - | - | - | | `metadata` | objet (JSON) | JSON libre que vous contrôlez. À utiliser pour les tags internes, le niveau, la source d'inscription, etc. | | `tags[]` | tableau | Tags gérés depuis la console ou l'API, pour filtrer et regrouper | Les métadonnées n'ont pas de schéma : Didit conserve tout ce que vous écrivez. ## Relations (non stockées dans la ligne de l'utilisateur) | Relation | Accès | | - | - | | Sessions | `GET /v3/sessions?vendor_data=` | | Transactions (en tant que demandeur) | `GET /v3/transactions/?vendor_data=` | | Transactions (en tant que contrepartie) | Filtrer la liste des transactions par vendor\_data de la contrepartie dans la console | | Entreprises liées (dirigeant / UBO) | Affichées sur la page de détail de l'utilisateur dans la console | | Données biométriques faciales | Console + Lists API | | Entrées de liste de blocage | [Lists API](https://docs.didit.me/fr/management-api/lists/overview.md), filtrer les entrées selon les identifiants de l'utilisateur | ## Exemple de réponse ```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" } } ``` ## Prochaines étapes > [card] [Opérations](https://docs.didit.me/fr/entities/users/operations.md) > > Créer, mettre à jour, modifier le statut, supprimer. > [card] [Historique KYC](https://docs.didit.me/fr/entities/users/kyc-history.md) > > Récupérer toutes les sessions liées à l'utilisateur. > [card] [Référence de l'API](https://docs.didit.me/fr/management-api/users/get.md) > > Schéma de l'endpoint GET /v3/users/{vendor_data}/. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.