Overview
Care Team Members Information addresses:- CareTeam HL7® FHIR® resource with US Core Profile 6.1.0
- a patient
- a participant role for each careteam members
- a reference to each careteam member which can be:
- a practitioner or practitioner type (doctor, nurse, therapist)
- a relative or friend or guardian
- a status code
- US Core Practitioner Profile
- US Core PractitionerRole Profile
- US Core RelatedPerson Profile
US Core Practitioner Profile and US Core PractitionerRole are must support, the server system is not required to support both types of references (and _include search parameters), but SHALL support at least one of them.
The client application SHALL support all three profile references.
Because the US Core PractitionerRole Profile supplies the provider’s location and contact information and a reference to the Practitioner, server systems SHOULD reference it instead of the US Core Practitioner Profile. An example of how to access the practitioner name and identifier is shown in the quick start section below.
Servers that support only US Core Practitioner Profile SHALL provide implementation specific guidance how to access a provider’s location and contact information using only the Practitioner resource.
This resource conforms to USCDI v3 for Care Team Members - refers to US Core CareTeam Profile 6.1.0. CareTeam response will be provided in JSON (refers to Capability Statement) format as per FHIR standard R4 version.
Must support elements, mandatory and optional search parameters
CareTeammust support these elements:statussubjectparticipantrolemember
subjectparticipantrolemember
patient and status search parameters:
- including optional support for these
_includeparameters:CareTeam:participant:PractitionerRoleCareTeam:participant:PractitionerCareTeam:participant:PatientCareTeam:participant:RelatedPerson
- including support for OR search on status (e.g.status={system|}[code],{system|}[code],…)
GET [base url]/CareTeam?patient={Type/}[id]&status=active
The following search parameter combinations SHOULD be supported:
SHOULD support searching using the combination of the patient and role search parameters:
- including optional support for these
_includeparameters:CareTeam:participant:PractitionerRoleCareTeam:participant:PractitionerCareTeam:participant:PatientCareTeam:participant:RelatedPerson
GET [base url]/CareTeam?patient={Type/}[id]&role={system|}[code]
The response to any search operation is always a list of resources in a Bundle or an Operation Outcome.
CareTeam by Patient and Status
Search for CareTeam using combination ofpatient and status parameters.
METHOD GET
Patient/
[id] - Patient’s id
HEADERS
The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to Authentication and Authorization for further details.
RESPONSES
The response to any search operation is always a list of resources in a Bundle or an Operation Outcome.
EXAMPLE:
CareTeam by Patient and Status with Include Parameters
Search for CareTeam with included participant resources. METHOD GETPatient/
[id] - Patient’s id
_include - Include related participant resources in the response bundle
HEADERS
The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to Authentication and Authorization for further details.
RESPONSES
The response to any search operation is always a list of resources in a Bundle or an Operation Outcome.
EXAMPLE:
CareTeam by Patient and Role
Search for CareTeam using combination ofpatient and role parameters.
METHOD GET
Patient/
[id] - Patient’s id
{system|} - Role system. FHIR search token parameter. See Search specification for more information. Example: http://snomed.info/sct|
[code] - Role code. Example: 223366009 (Healthcare professional)
HEADERS
The Authorization token SHALL be obtained during the Authentication and Authorization process. Go to Authentication and Authorization for further details.
RESPONSES
The response to any search operation is always a list of resources in a Bundle or an Operation Outcome.
EXAMPLE: