CareTeam
Overview
The CareTeam resource represents a patient’s care team members. Care team members or participants include medical practitioners (physicians, nurses, technicians, and so on), family members, and guardians. The care team can be specific to an encounter or to the patient across all encounters (longitudinal).
Soarian Clinicals® supports a read-only Application Programming Interface (API). This API accepts GET
and POST
based search and GET
based read interactions. The response represents the most current information about the patient that is charted in Soarian Clinicals® at the time of the query.
The search results include the following fields if they contain values:
- Care Team id
- Status
- Category (Longitudinal or Encounter)
- Subject (Patient only)
- Encounter (Encounter Category only)
- Participant
Terminology Bindings
CareTeam.category |
|
CareTeam.participant.role |
|
Search
Search for CareTeam resources that meet the specified query parameters:
GET /CareTeam?:parameters
Authorization Types
Parameters
Name | Required? | Type | Description |
---|---|---|---|
_id |
This, or patient
|
token |
The logical resource ID associated with the resource. |
patient |
This, or _id
|
reference |
The patient who has the care team. |
encounter |
No | reference |
The encounter associated with the care team |
status |
No | token |
The status of the care team. May be a list separated by commas. |
_revinclude |
No | _revinclude |
A request to include any Provenance resource in the bundle that refers to an CareTeam resource in the search results. Only supported with Provenance. |
Notes
- The
status
parameter only supports the codesactive
andinactive
. - The
_revinclude
parameter may be provided once with the valueProvenance:target
. Example:_revinclude=Provenance:target
- When
_revinclude
is provided in a request, the OAuth2 token must include thepatient/Provenance.read system/Provenance.read
oruser/Provenance.read
scope as applicable.
Headers
Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>
Example Search by Patient
Request
GET https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/CareTeam?patient=A879904FD2FE4B2D90C89FDA84E1285F
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "febd05c0-d891-4f72-b39b-1b41900d646e",
"type": "searchset",
"timestamp": "2021-03-15T12:58:14-04:00",
"entry": [
{
"fullUrl": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam/A879904FD2FE4B2D90C89FDA84E1285F.LCC",
"resource": {
"resourceType": "CareTeam",
"id": "A879904FD2FE4B2D90C89FDA84E1285F.LCC",
"meta": {
"lastUpdated": "2020-11-11T20:50:58-05:00"
},
"status": "active",
"subject": {
"reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
"display": "Mcgovern,Astrid Santiago"
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LA28865-6",
"display": "Longitudinal care-coordination focused care team"
}
]
}
],
"participant": [
{
"role": [
{
"text": "Primary Physician"
}
],
"member": {
"reference": "Practitioner/A06BB34813644589BA7E50D8DDC8EFAA",
"display": "McFadden,John"
}
}
],
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>CareTeam</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago<br /><b>Status</b>:active<br /><b>Category</b>:<b>System</b>:http://loinc.org <b>Code</b>:LA28865-6 <b>Display</b>:Longitudinal care-coordination focused care team<br /><b>Role</b>:<b>Text</b>:Primary Physician<br /><b>CareTeam Member</b>:McFadden,John<br /><br /></div>"
}
}
},
{
"fullUrl": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam/A879904FD2FE4B2D90C89FDA84E1285F.ENC.29019",
"resource": {
"resourceType": "CareTeam",
"id": "A879904FD2FE4B2D90C89FDA84E1285F.ENC.29019",
"meta": {
"lastUpdated": "2020-11-11T20:53:17-05:00"
},
"status": "active",
"subject": {
"reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
"display": "Mcgovern,Astrid Santiago"
},
"encounter": {
"reference": "Encounter/A879904FD2FE4B2D90C89FDA84E1285F.29019",
"display": "Inferno,Initial"
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LA27976-2",
"display": "Encounter-focused care team"
}
]
}
],
"participant": [
{
"role": [
{
"coding": [
{
"system": "http://nucc.org/provider-taxonomy",
"code": "207QA0000X",
"display": "Family Medicine"
}
],
"text": "Consulting Doctor"
}
],
"member": {
"reference": "Practitioner/4F69EC72C5AA48988E5E73832887E634",
"display": "Aguilar,Melva Delaine"
}
},
{
"role": [
{
"text": "Consulting Doctor"
}
],
"member": {
"reference": "Practitioner/D8A9F3EADBE041688ADD843BBD98CAB0",
"display": "O'Reilly,Rose"
}
},
{
"role": [
{
"coding": [
{
"system": "http://nucc.org/provider-taxonomy",
"code": "208D00000X",
"display": "General Practice"
}
],
"text": "Admitting Doctor"
}
],
"member": {
"reference": "Practitioner/DF2821C049CC47E6A37C6B796DF4CF1D",
"display": "Godziszewski,Janet Kris"
}
},
{
"role": [
{
"coding": [
{
"system": "http://nucc.org/provider-taxonomy",
"code": "208D00000X",
"display": "General Practice"
}
],
"text": "Attending Doctor"
}
],
"member": {
"reference": "Practitioner/DF2821C049CC47E6A37C6B796DF4CF1D",
"display": "Godziszewski,Janet Kris"
}
}
],
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>CareTeam</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago<br /><b>Status</b>:active<br /><b>Encounter</b>:Inferno,Initial<br /><b>Category</b>:<b>System</b>:http://loinc.org <b>Code</b>:LA27976-2 <b>Display</b>:Encounter-focused care team<br /><b>Role</b>:<b>System</b>:http://nucc.org/provider-taxonomy <b>Code</b>:207QA0000X <b>Display</b>:Family Medicine <b>Text</b>:Consulting Doctor<br /><b>CareTeam Member</b>:Aguilar,Melva Delaine<br /><b>Role</b>:<b>Text</b>:Consulting Doctor<br /><b>CareTeam Member</b>:O'Reilly,Rose<br /><b>Role</b>:<b>System</b>:http://nucc.org/provider-taxonomy <b>Code</b>:208D00000X <b>Display</b>:General Practice <b>Text</b>:Admitting Doctor<br /><b>CareTeam Member</b>:Godziszewski,Janet Kris<br /><b>Role</b>:<b>System</b>:http://nucc.org/provider-taxonomy <b>Code</b>:208D00000X <b>Display</b>:General Practice <b>Text</b>:Attending Doctor<br /><b>CareTeam Member</b>:Godziszewski,Janet Kris<br /><br /></div>"
}
}
}
],
"link": [
{
"relation": "self",
"url": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam?patient=A879904FD2FE4B2D90C89FDA84E1285F&_format=json"
}
]
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site
Example Search by ID
Request
GET https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/CareTeam?_id=A879904FD2FE4B2D90C89FDA84E1285F.LCC
Response
Status: 200 OK
{
"resourceType": "Bundle",
"id": "e38b6e4f-0696-4980-b454-91d007cd3a97",
"type": "searchset",
"timestamp": "2021-03-15T13:53:58-04:00",
"entry": [
{
"fullUrl": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam/A879904FD2FE4B2D90C89FDA84E1285F.LCC",
"resource": {
"resourceType": "CareTeam",
"id": "A879904FD2FE4B2D90C89FDA84E1285F.LCC",
"meta": {
"lastUpdated": "2020-11-11T20:50:58-05:00"
},
"status": "active",
"subject": {
"reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
"display": "Mcgovern,Astrid Santiago"
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LA28865-6",
"display": "Longitudinal care-coordination focused care team"
}
]
}
],
"participant": [
{
"role": [
{
"text": "Primary Physician"
}
],
"member": {
"reference": "Practitioner/A06BB34813644589BA7E50D8DDC8EFAA",
"display": "McFadden,John"
}
}
],
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>CareTeam</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago<br /><b>Status</b>:active<br /><b>Category</b>:<b>System</b>:http://loinc.org <b>Code</b>:LA28865-6 <b>Display</b>:Longitudinal care-coordination focused care team<br /><b>Role</b>:<b>Text</b>:Primary Physician<br /><b>CareTeam Member</b>:McFadden,John<br /><br /></div>"
}
}
}
],
"link": [
{
"relation": "self",
"url": "https://fhir-myrecord-sc.sandboxcerner.com/r4/3f2aca24-87f3-4eac-a6d7-1f75247e6b43/CareTeam?_id=A879904FD2FE4B2D90C89FDA84E1285F.LCC&_format=json"
}
]
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.
Retrieve by ID
List an individual CareTeam resource by its ID:
GET /CareTeam/:id
Authorization Types
Headers
Accept: application/fhir+json
Authorization: <OAuth2 Bearer Token>
Example
Request
GET https://fhir-myrecord-sc.cerner.com/r4/2f8f5ec1-b7b8-4be5-ae27-e308284dd9c1/CareTeam/A879904FD2FE4B2D90C89FDA84E1285F.LCC
Response
Status: 200 OK
{
"resourceType": "CareTeam",
"id": "A879904FD2FE4B2D90C89FDA84E1285F.LCC",
"meta": {
"lastUpdated": "2020-11-11T20:50:58-05:00"
},
"status": "active",
"subject": {
"reference": "Patient/A879904FD2FE4B2D90C89FDA84E1285F",
"display": "Mcgovern,Astrid Santiago"
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "LA28865-6",
"display": "Longitudinal care-coordination focused care team"
}
]
}
],
"participant": [
{
"role": [
{
"text": "Primary Physician"
}
],
"member": {
"reference": "Practitioner/A06BB34813644589BA7E50D8DDC8EFAA",
"display": "McFadden,John"
}
}
],
"text": {
"status": "generated",
"div": "<div xmlns="http://www.w3.org/1999/xhtml"><b>CareTeam</b><br /><b>Patient</b>:Mcgovern,Astrid Santiago<br /><b>Status</b>:active<br /><b>Category</b>:<b>System</b>:http://loinc.org <b>Code</b>:LA28865-6 <b>Display</b>:Longitudinal care-coordination focused care team<br /><b>Role</b>:<b>Text</b>:Primary Physician<br /><b>CareTeam Member</b>:McFadden,John<br /><br /></div>"
}
}
Note: The examples provided here are non-normative and replaying them in the public sandbox is not guaranteed to yield the results shown on the site.
Errors
The common errors and OperationOutcomes may be returned.