IdentityVerification

Identity verification status and traits for patient identification. Supports French INS (Identité Nationale de Santé), European eIDAS, and other regional identity verification systems.

13 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
verifiedboolean

Whether the patient identity has been verified against an authoritative source

Example: true

Required
verificationMethodstring

Method used for verification (INS, eIDAS, national-id, passport, etc.)

Example: "INS"

Required
verificationDateDate

Date when identity was verified

Example: "2024-11-15"

Optional
verifiedByOrganization

Organization or authority that verified the identity

Optional
identityTraitsobject

Core identity traits used for verification. For French INS: birthName (nom de naissance), birthGivenNames (prénoms de naissance), birthDate, sex, birthPlace (lieu de naissance - code INSEE)

Required
nationalIdentifierstring

National health identifier. For France: NIR (Numéro d'Inscription au Répertoire) or NIA (Numéro Identifiant d'Attente)

Example: "1 75 08 75 123 456 78"

Optional
qualificationLevelstring

Quality level of identity verification. France: 'identité qualifiée' (qualified), 'identité récupérée' (recovered), 'identité provisoire' (provisional)

Example: "identité qualifiée"

Optional
eIDASLevelstring

European eIDAS assurance level (low, substantial, high) for cross-border authentication

Example: "high"

Optional
documentTypestring

Type of identity document used (national-id-card, passport, residence-permit, birth-certificate, carte-vitale)

Example: "carte-vitale"

Optional
documentNumberstring

Document number or reference

Optional
issuingAuthoritystring

Authority that issued the identity document

Example: "République Française"

Optional
expirationDateDate

Expiration date of identity document or verification

Example: "2030-12-31"

Optional
metadataobject

Additional verification metadata (session ID, operator ID, confidence score, etc.)

Optional

Examples

Example 1

{
  "@type": "IdentityVerification",
  "verified": true,
  "verificationMethod": "INS",
  "verificationDate": "2024-11-15",
  "verifiedBy": {
    "@type": "Organization",
    "name": "Agence du Numérique en Santé (ANS)"
  },
  "identityTraits": {
    "birthName": "MARTIN",
    "birthGivenNames": [
      "Marie",
      "Louise"
    ],
    "birthDate": "1985-03-20",
    "sex": "F",
    "birthPlace": "75112",
    "birthPlaceLabel": "Paris 12e"
  },
  "nationalIdentifier": "2 85 03 75 112 123 45",
  "qualificationLevel": "identité qualifiée",
  "documentType": "carte-vitale",
  "documentNumber": "123456789012345",
  "issuingAuthority": "Assurance Maladie",
  "metadata": {
    "insVersion": "2.1",
    "verificationSession": "VS-2024-001234",
    "confidenceScore": 0.99
  }
}

Example 2

{
  "@type": "IdentityVerification",
  "verified": true,
  "verificationMethod": "eIDAS",
  "verificationDate": "2024-11-10",
  "eIDASLevel": "high",
  "identityTraits": {
    "surname": "Schmidt",
    "givenNames": [
      "Hans",
      "Peter"
    ],
    "birthDate": "1978-06-15",
    "placeOfBirth": "Berlin, Germany"
  },
  "documentType": "national-id-card",
  "documentNumber": "T220001293",
  "issuingAuthority": "Federal Republic of Germany",
  "expirationDate": "2029-06-14"
}