Practitioner resource (FHIR R4)

Practitioner is the FHIR R4 resource for a person who is directly or indirectly involved in the provisioning of healthcare.

Resource	Practitioner
FHIR version	R4 (4.0.1)
Canonical URL	http://hl7.org/fhir/StructureDefinition/Practitioner
Required elements	none; every top-level element is optional (min 0) in base R4
IG profiles in this catalog	2

Example

{
  "resourceType": "Practitioner",
  "id": "practitioner-8b8e3b604fa54b98882673d5bee95e57",
  "active": true,
  "name": [
    {
      "use": "official",
      "family": "Williamson",
      "given": [
        "Rosa"
      ],
      "prefix": [
        "Dr."
      ],
      "text": "Dr. Williamson, Rosa"
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "+1-555-0123",
      "use": "work"
    },
    {
      "system": "email",
      "value": "rosa.williamson@hospital.org",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "type": "physical",
      "line": [
        "123 Medical Center Dr"
      ],
      "city": "Healthcare City",
      "state": "HC",
      "postalCode": "12345",
      "country": "US"
    }
  ],
  "gender": "unknown",
  "qualification": [
    {
      "identifier": [
        {
          "use": "official",
          "type": {
            "coding": [
              {
                "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
                "code": "MD",
                "display": "Medical License number"
              }
            ]
          },
          "system": "http://hl7.org/fhir/sid/us-npi",
          "value": "1814221653"
        }
  ...

Generated by the Pidgeon engine: pidgeon generate Practitioner --seed 20260722. Truncated for display; the command reproduces the full resource.

Validation context

strict pidgeon validate grades a Practitioner instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup Practitioner

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.