Practitioner

The FHIR R4 Practitioner resource describes an individual involved in the delivery of healthcare services, such as a physician, nurse, therapist, or pharmacist. This resource captures demographics, credentials, contact details, and affiliations with healthcare organizations.

Use Cases

  • Identify the clinician responsible for a medication, diagnosis, or encounter
  • Display provider contact details for care coordination
  • Associate a practitioner with their roles, specialties, and organizations

Base URLs

Authentication

All requests require OAuth 2.0 authentication using a Bearer Token. Unauthorized requests return 401 Unauthorized responses.

Required Scope: practitioner.read for GET

For more information, go to: OAuth 2.0 Authentication.

Supported Methods

MethodOperationDescription
GETRead PractitionerRetrieves a specific Practitioner record by its FHIR ID.
GETSearch PractitionerSearches for Practitioner records using supported parameters.

Frequently Used Search Parameters

ParameterDescriptionFHIR Value Set / Example ValuesFHIR Data TypeRequired
nameSearches by first, last, or full name"Jane Smith"stringNo
identifierSearches by provider identifierNPI, state license numbertokenNo
telecomSearches by phone or email"555-123-4567"tokenNo
_idFilters by the FHIR Practitioner IDPractitioner/{id}tokenNo

Commonly Returned Resource Attributes

AttributeDescriptionExample ValuesFHIR Data TypeRequired
idUnique FHIR ID for the practitionerpract-456789idYes
identifierNational or state license identifiersNPI: 1234567890Identifier[]No
nameFull name of the practitionerJane Smith, MDHumanName[]Yes
telecomContact information555-555-5555, [email protected]ContactPoint[]No
addressWork address123 Wellness Way, Sunnyvale, CAAddress[]No
genderGender identityfemalecodeNo
birthDateDate of birth1975-05-10dateNo
qualificationDegrees, board certifications, or licensesMD, Board Certified Internal MedicinePractitioner.Qualification[]No
communicationLanguages spoken by the practitioneren, es, zhCodeableConcept[]No

Webhooks

Practitioner resources are not typically the direct subject of webhook notifications, but they are frequently referenced in payloads for clinical events such as MedicationRequest, Encounter, and Condition.

For more information, go to: Webhooks & Polling.

Error Handling

All Practitioner operations follow standard Health Gorilla error handling, including use of FHIR OperationOutcome for structured responses.
For more information, go to: Error Handling.

Additional Resources

HL7 FHIR Practitioner