PractitionerLicense

A professional license authorizing a practitioner to practice healthcare in a specific jurisdiction. Tracks license number, type, issuing authority, validity period, and current status.

Overview

PractitionerLicense represents the legal authorization granted by a regulatory body allowing a healthcare professional to practice. Licenses are jurisdiction-specific - a practitioner may need separate licenses for each state, province, or country where they practice. The entity tracks the license identifier, type, issuing authority, validity dates, and current status to support credentialing and compliance verification.

Key Concepts

License Components

Each license record contains:

Field	Purpose	Example
`identifier`	License number and system	MD-MA-987654
`type`	Type of license	Medical Doctor (MD)
`jurisdiction`	Where license is valid	Massachusetts
`issuingAuthority`	Licensing board	MA Board of Medicine
`validityPeriod`	Dates of validity	2022-01-01 to 2026-12-31
`status`	Current license state	active

Jurisdiction

Licenses are valid only within their jurisdiction:

United States

State-level licensing (e.g., Massachusetts, California)
Each state has its own medical board

United Kingdom

National licensing through GMC, NMC
Valid throughout UK

European Union

Country-level with mutual recognition
Varying requirements by member state

License Status

Status	Meaning	Can Practice?
`active`	Valid and in good standing	Yes
`expired`	Validity period has ended	No
`suspended`	Temporarily revoked	No
`revoked`	Permanently cancelled	No
`pending`	Application in process	No

Validity Period

The validityPeriod via Period:

startDate - When license became effective
endDate - When license expires (requires renewal)

Some licenses (e.g., UK GMC) may have no end date (continuous registration).

Calculated Field

isActive - Computed boolean that is true when:

Status is active
Current date is within validity period

Use Cases

Credentialing

When onboarding a practitioner:

Collect license documentation
Verify with issuing authority
Create license record with verified details
Set up renewal reminders
Monitor for status changes

Practice Authorization

Before allowing practice:

Query practitioner's licenses
Check isActive for relevant jurisdiction
Verify license type matches role
Document verification
Block if no valid license

Multi-State Practice

For practitioners in multiple jurisdictions:

Maintain license for each state
Track different renewal dates
Verify active license for patient's location
Support telehealth licensing requirements

License Renewal

When license approaches expiration:

Query licenses with upcoming endDate
Alert practitioner of renewal need
Track renewal application status
Update validity period when renewed
Update status if not renewed

Compliance Reporting

For regulatory compliance:

Report license coverage by jurisdiction
Identify expiring licenses
Track disciplinary actions (suspended/revoked)
Document verification audits

Related Entities

Entity	Relationship	Description
Practitioner	Belongs to	The practitioner holding this license
PractitionerLicenseType	References	Type of professional license
Identifier	Contains	License number and system
Organization	References	Licensing authority that issued the license
Period	Contains	Validity date range

Calculated Fields

Field	Type	Description
`isActive`	boolean	True if status is active and current date is within validity period

Enums

status

Value	Description
`active`	License is valid and in good standing
`expired`	License validity period has ended, renewal required
`suspended`	License temporarily suspended by licensing authority
`revoked`	License permanently cancelled, cannot be renewed
`pending`	License application submitted, awaiting approval

8 properties

Schema

Properties

Property	Type	Mode	Description	Required
practitioner	Practitioner	stored	Practitioner holding this license	Required
identifier	Identifier	stored	License identifier with number and system	Required
type	PractitionerLicenseType	stored	Type of professional license	Required
jurisdiction	string	stored	Jurisdiction where the license is valid (state, province, country) Example: `"Massachusetts"`	Required
issuingAuthority	Organization	stored	Authority that issued the license	Optional
validityPeriod	Period	stored	Period during which the license is valid	Optional
status	string	stored	Current status of the license Values: `active, expired, suspended, revoked, pending` Example: `"active"`	Required
isActive	boolean	calculated	Whether the license is currently active and valid	Optional

Examples

Example 1

{
  "@type": "PractitionerLicense",
  "practitioner": {
    "@type": "Practitioner",
    "givenName": "Michael",
    "familyName": "Chen"
  },
  "identifier": {
    "@type": "Identifier",
    "system": "MA-MEDICAL-BOARD",
    "value": "MD-MA-987654",
    "type": "license"
  },
  "type": {
    "@type": "PractitionerLicenseType",
    "code": "MD",
    "label": "Medical Doctor"
  },
  "jurisdiction": "Massachusetts",
  "issuingAuthority": {
    "@type": "Organization",
    "name": "Massachusetts Board of Registration in Medicine"
  },
  "validityPeriod": {
    "@type": "Period",
    "startDate": "2022-01-01",
    "endDate": "2026-12-31"
  },
  "status": "active"
}

Example 2

{
  "@type": "PractitionerLicense",
  "practitioner": {
    "@type": "Practitioner",
    "givenName": "Emily",
    "familyName": "Davis"
  },
  "identifier": {
    "@type": "Identifier",
    "system": "GMC-UK",
    "value": "7654321",
    "type": "license"
  },
  "type": {
    "@type": "PractitionerLicenseType",
    "code": "GMC",
    "label": "General Medical Council Registration"
  },
  "jurisdiction": "United Kingdom",
  "issuingAuthority": {
    "@type": "Organization",
    "name": "General Medical Council"
  },
  "validityPeriod": {
    "@type": "Period",
    "startDate": "2020-06-01"
  },
  "status": "active"
}