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:

Terminology Bindings

CareTeam.category
  • Description
    • Identifies the type of team.
  • Details: LOINC

CareTeam.participant.role
  • Description
    • Role of participant in care team.
  • Details: Participant Role
    System: https://nucc.org/provider-taxonomy

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

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.