@cef-ebsi/vcdm1.1-dc4eu-doctor-id

Doctor ID

Schema for physicians identity credentials

The schema is published to the Trusted Schemas Registry with the IDs:

• 0x84373c5db617b832d3c7f9e2da8ee29d9358d11db4081cf9f4020cc3b5f7e62e (hexadecimal)
• z9u7fgZ7quje89V13cHcvNvAnhc47Qz4Eo8nyhwAUhQDj (multibase base58btc)

Table of Contents

• JSON Schema
• Installation
• Usage
• License

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Doctor ID",
  "description": "Schema for physicians identity credentials",
  "type": "object",
  "allOf": [
    {
      "$ref": "./node_modules/@cef-ebsi/vcdm1.1-attestation-schema/schema.json"
    },
    {
      "properties": {
        "id": {
          "type": "string",
          "format": "uri",
          "description": "Unique identifier for the doctor ID credential"
        },
        "type": {
          "type": "array",
          "description": "Credential type definitions",
          "items": {
            "type": "string"
          },
          "default": [
            "VerifiableCredential",
            "VerifiableAttestation",
            "DoctorIdCredential"
          ]
        },
        "issuer": {
          "type": "object",
          "description": "Information about the issuing institution",
          "properties": {
            "id": {
              "type": "string",
              "format": "uri",
              "description": "Unique identifier of the issuing institution"
            },
            "name": {
              "type": "object",
              "description": "Multilingual name of the issuing institution",
              "additionalProperties": {
                "type": "string"
              }
            }
          },
          "required": ["id", "name"]
        },
        "issuanceDate": {
          "type": "string",
          "format": "date-time",
          "description": "Date when the doctor ID was issued"
        },
        "credentialSubject": {
          "type": "object",
          "description": "Information about the doctor and their status",
          "properties": {
            "id": {
              "type": "string"
            },
            "givenName": {
              "description": "Current first name(s), including middle name(s) where applicable, of the doctor.",
              "type": "string"
            },
            "familyName": {
              "description": "Current last name(s) or surname(s) of the doctor.",
              "type": "string"
            },
            "medicalBoard": {
              "description": "Corresponds to the regional professional body of physicians where the professional is registered.",
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Álava/Áraba",
                  "Albacete",
                  "Alicante",
                  "Almería",
                  "Ávila",
                  "Badajoz",
                  "Islas Baleares/Illes Balears",
                  "Barcelona",
                  "Burgos",
                  "Cáceres",
                  "Cádiz",
                  "Castellón",
                  "Ciudad Real",
                  "Córdoba",
                  "La Coruña/A Coruña",
                  "Cuenca",
                  "Gerona/Girona",
                  "Granada",
                  "Guadalajara",
                  "Guipúzcoa/Gipuzkoa",
                  "Huelva",
                  "Huesca",
                  "Jaén",
                  "León",
                  "Lérida/Lleida",
                  "La Rioja",
                  "Lugo",
                  "Madrid",
                  "Málaga",
                  "Murcia",
                  "Navarra",
                  "Orense/Ourense",
                  "Asturias",
                  "Palencia",
                  "Las Palmas",
                  "Pontevedra",
                  "Salamanca",
                  "Santa Cruz de Tenerife",
                  "Cantabria",
                  "Segovia",
                  "Sevilla",
                  "Soria",
                  "Tarragona",
                  "Teruel",
                  "Toledo",
                  "Valencia",
                  "Valladolid",
                  "Vizcaya/Bizkaia",
                  "Zamora",
                  "Zaragoza",
                  "Ceuta",
                  "Melilla"
                ]
              }
            },
            "personalAdministrativeNumber": {
              "description": "Identification number of the registered physician.",
              "type": "string",
              "pattern": "([0-9]{9})"
            },
            "legallyEntitled": {
              "description": "Defines whether the professional is considered to be qualified to practise medicine, and there is no record of the professional having been sanctioned or disqualified from practising as a doctor..",
              "type": "boolean"
            },
            "medicalSpeciality": {
              "description": "Code representing the clinical specialty of the clinician or provider who interacted with, treated, or provided a service to/for the patient",
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "Allergology",
                  "Clinical Analysis",
                  "Pathological Anatomy",
                  "Anesthesiology and Reanimation",
                  "Angiology and Vascular Surgery",
                  "Digestive System",
                  "Clinical Biochemistry",
                  "Cardiology",
                  "Cardiovascular Surgery",
                  "General and Digestive Surgery",
                  "Oral and Maxillofacial Surgery",
                  "Orthopedic Surgery and Traumatology",
                  "Pediatric Surgery",
                  "Plastic, Aesthetic, and Reconstructive Surgery",
                  "Thoracic Surgery",
                  "Medical-Surgical Dermatology and Venereology",
                  "Endocrinology and Nutrition",
                  "Stomatology",
                  "Clinical Pharmacology",
                  "Geriatrics",
                  "Medical Hydrology",
                  "Hematology and Hemotherapy",
                  "Immunology",
                  "Occupational Medicine",
                  "Family and Community Medicine",
                  "Physical Education and Sports Medicine",
                  "Forensic Medicine",
                  "Physical Medicine and Rehabilitation",
                  "Intensive Medicine",
                  "Internal Medicine",
                  "Nuclear Medicine",
                  "Preventive Medicine and Public Health",
                  "Microbiology and Parasitology",
                  "Nephrology",
                  "Pulmonology",
                  "Neurosurgery",
                  "Clinical Neurophysiology",
                  "Neurology",
                  "Obstetrics and Gynecology",
                  "Ophthalmology",
                  "Medical Oncology",
                  "Radiation Oncology",
                  "Otorhinolaryngology",
                  "Pediatrics and its Specific Areas",
                  "Psychiatry",
                  "Radiology",
                  "Rheumatology",
                  "Urology",
                  "General Medicine",
                  "Child and Adolescent Psychiatry",
                  "Certified General Physician"
                ]
              }
            }
          },
          "required": [
            "id",
            "givenName",
            "familyName",
            "personalAdministrativeNumber",
            "medicalSpeciality"
          ]
        },
        "proof": {
          "type": "object",
          "description": "Cryptographic proof of the credential",
          "properties": {
            "type": {
              "type": "string",
              "description": "Type of proof"
            },
            "created": {
              "type": "string",
              "format": "date-time",
              "description": "Date and time when the proof was created"
            },
            "proofPurpose": {
              "type": "string",
              "description": "Purpose of the proof"
            },
            "verificationMethod": {
              "type": "string",
              "format": "uri",
              "description": "Method used to verify the proof"
            },
            "proofValue": {
              "type": "string",
              "description": "Value of the proof"
            }
          },
          "required": [
            "type",
            "created",
            "proofPurpose",
            "verificationMethod",
            "proofValue"
          ]
        }
      },
      "required": [
        "@context",
        "id",
        "type",
        "issuer",
        "issuanceDate",
        "expirationDate",
        "credentialSubject",
        "proof"
      ]
    }
  ]
}

Installation

# with npm
npm add @cef-ebsi/[email protected]

# with Yarn
yarn add @cef-ebsi/[email protected]

# with pnpm
pnpm add @cef-ebsi/[email protected]

Usage

The package exports the schema and its metadata as JavaScript objects:

import { schema, metadata } from "@cef-ebsi/vcdm1.1-dc4eu-doctor-id";

// you can now use the schema and metadata

In addition, the package exports a TypeScript type corresponding to the schema:

import type { DoctorID } from "@cef-ebsi/vcdm1.1-dc4eu-doctor-id";

License

Copyright (C) 2024 European Union

This program is free software: you can redistribute it and/or modify it under the terms of the EUROPEAN UNION PUBLIC LICENCE v. 1.2 as published by the European Union.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the EUROPEAN UNION PUBLIC LICENCE v. 1.2 for further details.

You should have received a copy of the EUROPEAN UNION PUBLIC LICENCE v. 1.2. along with this program. If not, see https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12.