Skip to main content

Practitioner

Overview​

The Practitioner resource represents a person who is directly or indirectly involved in the provisioning of healthcare. This includes physicians, nurses, therapists, and other healthcare professionals.

Resource Schema​

Key fields in the Practitioner resource:

{
  "resourceType": "Practitioner",
  "id": "example-practitioner-123",
  "active": true,
  "name": [
    {
      "family": "Smith",
      "given": ["John", "Michael"],
      "prefix": ["Dr."]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "555-987-6543"
    },
    {
      "system": "email",
      "value": "john.smith@example.com"
    }
  ],
  "qualification": [
    {
      "code": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/v2-0360",
            "code": "MD",
            "display": "Doctor of Medicine"
          }
        ]
      }
    }
  ]
}

Operations​

The Practitioner resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

Retrieves a specific Practitioner resource by ID.

HTTP Method: GET
URL: /Practitioner/{id}

Examples​

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Practitioner/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Retrieves Practitioner resources matching specified criteria.

HTTP Method: GET or POST
URL: /Practitioner or /Practitioner/_search

Examples​

Search Practitioners
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Practitioner \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns​

Common Workflows​

  1. Provider Lookup - Find healthcare practitioners by name or specialty
  2. Care Team Assembly - Identify practitioners involved in patient care
  3. Referral Processing - Look up practitioners for patient referrals

Relationships to Other Resources​

The Practitioner resource relates to:

  • Patient - Patients under the practitioner's care
  • Encounter - Healthcare encounters involving the practitioner
  • Organization - Organizations where the practitioner works
  • MedicationRequest - Prescriptions written by the practitioner

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​

Profiles supported by this resource (as defined in the CapabilityStatement):