Practitioner
The Practitioner resource provides the "person who is directly or indirectly involved in the provisioning of healthcare." (HL7 FHIR R4 Practitioner)
Supported Profiles
This API supports the following FHIR profiles:
Operations
Support for the different types of Conditions may vary by CareRecord. Please consult your target solution's documentation for more information.
The General Purpose FHIR R4 Practitioner resource supports the following standard operations. However, support varies by the targeted CareRecord or solution.
| CareRecord / Solution | Create | Read | Update | Search |
|---|---|---|---|---|
| GEHRIMED | - | Yes | - | Yes |
| myAvatar | Yes | Yes | Yes | Yes |
| myEvolv | - | Yes | - | Yes |
| myUnity | - | Yes | - | Yes |
| Referral Manager | - | - | - | - |
Search
This resource supports a combination of standard and custom search parameters in addition to the common parameters.
Standard Parameters
| Name | Type | Description |
|---|---|---|
| family | string | A portion of the family name of the practitioner |
| given | string | A portion of the given name of the practitioner |
| identifier | token | A practitioner identifier |
| name | string | A server defined search that may match any of the string fields in the HumanName, including family, give, prefix, suffix, suffix, and/or text |
| _id | id | Unique identifier of the Practitioiner. Cannot be used with other search parameters. |
Custom Parameters
| Name | Type | Description |
|---|---|---|
| npi | id | Practitioner NPI identifier. |
Search Examples
The POST method is recommended as it keeps health information out of the URL.
- Production
- Preview
curl -X POST https://fhir.netsmartcloud.com/v4/Practitioner/_search \
-H "Authorization: {Bearer Token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "name=john smith"
curl -X POST https://fhir.netsmartcloud.com/v4/Practitioner/_search \
-H "Authorization: {Bearer Token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "identifier=97860456"
curl -X POST https://fhirtest.netsmartcloud.com/v4/Practitioner/_search \
-H "Authorization: {Bearer Token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "name=john smith"
curl -X POST https://fhirtest.netsmartcloud.com/v4/Practitioner/_search \
-H "Authorization: {Bearer Token}" \
-H "Accept: application/fhir+json" \
-H "Content-Type: application/x-form-urlencoded" \
-d "identifier=97860456"
Special Considerations
The General Purpose API FHIR R4 Practitioner resource has the following considerations in addition to the shared special considerations.
Support for Fallback to Staff Member
The General Purpose API FHIR R4 Practitioner resource supports returning Staff Members as Practitioners. This functionality currently supports Read and Search.