Release 4 5

This page is part of the FHIR Specification (v4.0.1: R4 (v5.0.0: R5 - Mixed Normative and STU ) ). This is the current published version in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3

9.7 Resource CareTeam - Content

Patient Care icon Work Group Maturity Level : 2   Trial Use Security Category : Patient Compartments : Encounter , Patient , Practitioner , RelatedPerson

The Care Team includes all the people and organizations who plan to participate in the coordination and delivery of care for a patient. care.

The CareTeam includes all the people, teams, people and organizations who plan to participate in the coordination and delivery of care for and is assigned to:

  • a single patient patient, or
  • a group (such as a married couple in therapy or a support group). CareTeam can also be organizationally assigned without group), or
  • an event, prior to a subject in context, such being identified (such as a code blue team or emergency response team. This team)

Care Team is not limited to practitioners, but may include other caregivers such as family members, guardians, the patient themself, or others. The Care Team, depending on where used, may include care team members specific to a particular care plan, an episode, an encounter, or may reflect all known team members across these perspectives. An individual's CareTeam can be dynamic over time, such that there can be transience of team members, such as a rehabilitation team.

Care Team is distinct from Group. Group is patient-independent and identifies an undifferentiated set of individuals who are intended to be the target of one or more clinical activities (e.g. set of clinical trial participants, set of individuals impacted by or at risk of a public health event, a herd or flock, etc.) The CareTeam resource establishes a set of relationships and roles and is specific to participants within a particular Patient. The actors CareTeam are the individual members or organized group of individuals. CareTeam can be referenced by EpisodeOfCare, Encounter, or CarePlan to identify the set of individuals (and their respective roles) who are intended to be involved in providing the care defined by those resources.

This resource is referenced by

Structure

0..* Time period of participant 0..*
Name Flags Card. Type Description & Constraints doco
. . CareTeam TU DomainResource Planned participants in the coordination and delivery of care for a patient or group

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier External Ids for this team

. . . status ?! Σ 0..1 code proposed | active | suspended | inactive | entered-in-error
CareTeamStatus Binding: Care Team Status ( Required )
. . . category Σ 0..* CodeableConcept Type of team
Binding: Care Team category ( Example )

. . . subject Σ 0..1 Reference ( Patient | Group ) Who care team is for
. . encounter . period Σ 0..1 Reference ( Encounter ) Encounter created as part of period Σ 0..1 Period Time period team covers
. . . participant I C 0..* BackboneElement Members of the team
+ Rule: CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner
+ Warning: CareTeam.participant.role or CareTeam.participant.member exists

. . . . role Σ C 0..1 CodeableConcept Type of involvement
Binding: Participant Roles ( Example )
. . . . member Σ C 0..1 Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam ) Who is involved
. . . . onBehalfOf Σ C 0..1 Reference ( Organization ) Organization of the practitioner
. . . period . coverage[x] 0..1 When the member is generally available within this care team
..... coveragePeriod 0..1 Period
. reasonCode . . . . coverageTiming CodeableConcept Why the care team exists SNOMED CT Clinical Findings ( Example Timing )
. . . reasonReference reason 0..* Reference CodeableReference ( Condition ) Why the care team exists
Binding: SNOMED CT Clinical Findings ( Example )

. . . managingOrganization Σ 0..* Reference ( Organization ) Organization responsible for the care team

. . . telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)

. . . note 0..* Annotation Comments made about the CareTeam


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

CareTeam ( DomainResource ) Business identifiers assigned to this care team by the performer or other systems which remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..*] Indicates the current state of the care team (this element modifies the meaning of other elements) status : code [0..1] « Indicates the status of the care team. null (Strength=Required) CareTeamStatus ! » Identifies what kind of team. This is to support differentiation between multiple co-existing teams, such as care plan team, episode of care team, longitudinal care team category : CodeableConcept [0..*] « Indicates the type of care team. null (Strength=Example) CareTeamCategory ?? » A label for human use intended to distinguish like teams. E.g. the "red" vs. "green" trauma teams name : string [0..1] Identifies the patient or group whose intended care is handled by the team subject : Reference [0..1] « Patient | Group » The Encounter during which this CareTeam was created or to which the creation of this record is tightly associated encounter : Reference [0..1] « Encounter » Indicates when the team did (or is intended to) come into effect and end period : Period [0..1] Describes why the care team exists reasonCode reason : CodeableConcept CodeableReference [0..*] « Condition ; Indicates the reason for the care team. null (Strength=Example) SNOMEDCTClinicalFindings ?? » Condition(s) that this care team addresses reasonReference : Reference [0..*] « Condition SNOMEDCTClinicalFindings ?? » The organization responsible for the care team managingOrganization : Reference [0..*] « Organization » A central contact detail for the care team (that applies to all members) telecom : ContactPoint [0..*] Comments made about the CareTeam note : Annotation [0..*] Participant Indicates specific responsibility of an individual within the care team, such as "Primary care physician", "Trained social worker counselor", "Caregiver", etc role : CodeableConcept [0..*] [0..1] « Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc. null (Strength=Example) ParticipantRoles ?? » « This element has or is affected by some invariants C » The specific person or organization who is participating/expected to participate in the care team member : Reference [0..1] « Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam » « This element has or is affected by some invariants C » The organization of the practitioner onBehalfOf : Reference [0..1] « Organization » « This element has or is affected by some invariants C » Indicates when When the specific member or organization did (or is intended to) come into effect and end generally available within this care team period coverage[x] : Period DataType [0..1] « Period | Timing » Identifies all people and organizations who are expected to be involved in the care team participant [0..*]

XML Template

<

<CareTeam xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier External Ids for this team --></identifier>
 <status value="[code]"/><!-- 0..1 proposed | active | suspended | inactive | entered-in-error -->
 <category><!-- 0..* CodeableConcept Type of team --></category>
 <name value="[string]"/><!-- 0..1 Name of the team, such as crisis assessment team -->
 <</subject>
 <</encounter>

 <subject><!-- 0..1 Reference(Group|Patient) Who care team is for --></subject>

 <period><!-- 0..1 Period Time period team covers --></period>
 <
  <</role>
  <|
    </member>
  <</onBehalfOf>
  <</period>

 <participant>  <!-- 0..* Members of the team -->
  <role><!-- I 0..1 CodeableConcept Type of involvement --></role>
  <member><!-- I 0..1 Reference(CareTeam|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Who is involved --></member>

  <onBehalfOf><!-- I 0..1 Reference(Organization) Organization of the practitioner --></onBehalfOf>
  <coverage[x]><!-- 0..1 Period|Timing When the member is generally available within this care team --></coverage[x]>

 </participant>
 <</reasonCode>
 <</reasonReference>

 <reason><!-- 0..* CodeableReference(Condition) Why the care team exists --></reason>

 <managingOrganization><!-- 0..* Reference(Organization) Organization responsible for the care team --></managingOrganization>
 <telecom><!-- 0..* ContactPoint A contact detail for the care team (that applies to all members) --></telecom>
 <note><!-- 0..* Annotation Comments made about the CareTeam --></note>
</CareTeam>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:;

[ a fhir:CareTeam;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* External Ids for this team
  fhir:status [ code ] ; # 0..1 proposed | active | suspended | inactive | entered-in-error
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Type of team
  fhir:name [ string ] ; # 0..1 Name of the team, such as crisis assessment team
  fhir:subject [ Reference(Group|Patient) ] ; # 0..1 Who care team is for
  fhir:period [ Period ] ; # 0..1 Time period team covers
  fhir:participant ( [ # 0..* Members of the team
    fhir:role [ CodeableConcept ] ; # 0..1 I Type of involvement
    fhir:member [ Reference(CareTeam|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved
    fhir:onBehalfOf [ Reference(Organization) ] ; # 0..1 I Organization of the practitioner
    # coverage[x] : 0..1 When the member is generally available within this care team. One of these 2
      fhir:coverage [  a fhir:Period ; Period ]
      fhir:coverage [  a fhir:Timing ; Timing ]
  ] ... ) ;
  fhir:reason  ( [ CodeableReference(Condition) ] ... ) ; # 0..* Why the care team exists
  fhir:managingOrganization  ( [ Reference(Organization) ] ... ) ; # 0..* Organization responsible for the care team
  fhir:telecom  ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the care team (that applies to all members)
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Comments made about the CareTeam

]

Changes since R3 from both R4 and R4B

CareTeam
CareTeam.status CareTeam.participant.role
  • Change value set Max Cardinality changed from http://hl7.org/fhir/ValueSet/care-team-status * to http://hl7.org/fhir/ValueSet/care-team-status|4.0.1 1
CareTeam.encounter CareTeam.participant.coverage[x]
  • Added Element
CareTeam.participant.role CareTeam.reason
  • Max Cardinality changed from 1 to * Added Element
CareTeam.participant.member CareTeam.encounter
  • Type Reference: Added Target Type PractitionerRole Deleted (Avoid circular references since Encounter references CareTeam)
CareTeam.telecom CareTeam.participant.period
  • Added Element Deleted
CareTeam.context CareTeam.reasonCode
  • deleted Deleted (-> CareTeam.reason)
CareTeam.reasonReference
  • Deleted (-> CareTeam.reason)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

See R3 <--> R4 <--> R5 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors). ) See Conversions Summary .)

Structure

0..* Time period of participant 0..*
Name Flags Card. Type Description & Constraints doco
. . CareTeam TU DomainResource Planned participants in the coordination and delivery of care for a patient or group

Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier Σ 0..* Identifier External Ids for this team

. . . status ?! Σ 0..1 code proposed | active | suspended | inactive | entered-in-error
CareTeamStatus Binding: Care Team Status ( Required )
. . . category Σ 0..* CodeableConcept Type of team
Binding: Care Team category ( Example )

. . . subject Σ 0..1 Reference ( Patient | Group ) Who care team is for
. . encounter . period Σ 0..1 Reference ( Encounter ) Encounter created as part of period Σ 0..1 Period Time period team covers
. . . participant I C 0..* BackboneElement Members of the team
+ Rule: CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner
+ Warning: CareTeam.participant.role or CareTeam.participant.member exists

. . . . role Σ C 0..1 CodeableConcept Type of involvement
Binding: Participant Roles ( Example )
. . . . member Σ C 0..1 Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam ) Who is involved
. . . . onBehalfOf Σ C 0..1 Reference ( Organization ) Organization of the practitioner
. . . period . coverage[x] 0..1 When the member is generally available within this care team
..... coveragePeriod 0..1 Period
. reasonCode . . . . coverageTiming CodeableConcept Why the care team exists SNOMED CT Clinical Findings ( Example Timing )
. . . reasonReference reason 0..* Reference CodeableReference ( Condition ) Why the care team exists
Binding: SNOMED CT Clinical Findings ( Example )

. . . managingOrganization Σ 0..* Reference ( Organization ) Organization responsible for the care team

. . . telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)

. . . note 0..* Annotation Comments made about the CareTeam


doco Documentation for this format icon

See the Extensions for this resource

UML Diagram ( Legend )

CareTeam ( DomainResource ) Business identifiers assigned to this care team by the performer or other systems which remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..*] Indicates the current state of the care team (this element modifies the meaning of other elements) status : code [0..1] « Indicates the status of the care team. null (Strength=Required) CareTeamStatus ! » Identifies what kind of team. This is to support differentiation between multiple co-existing teams, such as care plan team, episode of care team, longitudinal care team category : CodeableConcept [0..*] « Indicates the type of care team. null (Strength=Example) CareTeamCategory ?? » A label for human use intended to distinguish like teams. E.g. the "red" vs. "green" trauma teams name : string [0..1] Identifies the patient or group whose intended care is handled by the team subject : Reference [0..1] « Patient | Group » The Encounter during which this CareTeam was created or to which the creation of this record is tightly associated encounter : Reference [0..1] « Encounter » Indicates when the team did (or is intended to) come into effect and end period : Period [0..1] Describes why the care team exists reasonCode reason : CodeableConcept CodeableReference [0..*] « Condition ; Indicates the reason for the care team. null (Strength=Example) SNOMEDCTClinicalFindings ?? » Condition(s) that this care team addresses reasonReference : Reference [0..*] « Condition SNOMEDCTClinicalFindings ?? » The organization responsible for the care team managingOrganization : Reference [0..*] « Organization » A central contact detail for the care team (that applies to all members) telecom : ContactPoint [0..*] Comments made about the CareTeam note : Annotation [0..*] Participant Indicates specific responsibility of an individual within the care team, such as "Primary care physician", "Trained social worker counselor", "Caregiver", etc role : CodeableConcept [0..*] [0..1] « Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc. null (Strength=Example) ParticipantRoles ?? » « This element has or is affected by some invariants C » The specific person or organization who is participating/expected to participate in the care team member : Reference [0..1] « Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam » « This element has or is affected by some invariants C » The organization of the practitioner onBehalfOf : Reference [0..1] « Organization » « This element has or is affected by some invariants C » Indicates when When the specific member or organization did (or is intended to) come into effect and end generally available within this care team period coverage[x] : Period DataType [0..1] « Period | Timing » Identifies all people and organizations who are expected to be involved in the care team participant [0..*]

XML Template

<

<CareTeam xmlns="http://hl7.org/fhir"> doco

 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier External Ids for this team --></identifier>
 <status value="[code]"/><!-- 0..1 proposed | active | suspended | inactive | entered-in-error -->
 <category><!-- 0..* CodeableConcept Type of team --></category>
 <name value="[string]"/><!-- 0..1 Name of the team, such as crisis assessment team -->
 <</subject>
 <</encounter>

 <subject><!-- 0..1 Reference(Group|Patient) Who care team is for --></subject>

 <period><!-- 0..1 Period Time period team covers --></period>
 <
  <</role>
  <|
    </member>
  <</onBehalfOf>
  <</period>

 <participant>  <!-- 0..* Members of the team -->
  <role><!-- I 0..1 CodeableConcept Type of involvement --></role>
  <member><!-- I 0..1 Reference(CareTeam|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) Who is involved --></member>

  <onBehalfOf><!-- I 0..1 Reference(Organization) Organization of the practitioner --></onBehalfOf>
  <coverage[x]><!-- 0..1 Period|Timing When the member is generally available within this care team --></coverage[x]>

 </participant>
 <</reasonCode>
 <</reasonReference>

 <reason><!-- 0..* CodeableReference(Condition) Why the care team exists --></reason>

 <managingOrganization><!-- 0..* Reference(Organization) Organization responsible for the care team --></managingOrganization>
 <telecom><!-- 0..* ContactPoint A contact detail for the care team (that applies to all members) --></telecom>
 <note><!-- 0..* Annotation Comments made about the CareTeam --></note>
</CareTeam>

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:;

[ a fhir:CareTeam;

  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* External Ids for this team
  fhir:status [ code ] ; # 0..1 proposed | active | suspended | inactive | entered-in-error
  fhir:category  ( [ CodeableConcept ] ... ) ; # 0..* Type of team
  fhir:name [ string ] ; # 0..1 Name of the team, such as crisis assessment team
  fhir:subject [ Reference(Group|Patient) ] ; # 0..1 Who care team is for
  fhir:period [ Period ] ; # 0..1 Time period team covers
  fhir:participant ( [ # 0..* Members of the team
    fhir:role [ CodeableConcept ] ; # 0..1 I Type of involvement
    fhir:member [ Reference(CareTeam|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved
    fhir:onBehalfOf [ Reference(Organization) ] ; # 0..1 I Organization of the practitioner
    # coverage[x] : 0..1 When the member is generally available within this care team. One of these 2
      fhir:coverage [  a fhir:Period ; Period ]
      fhir:coverage [  a fhir:Timing ; Timing ]
  ] ... ) ;
  fhir:reason  ( [ CodeableReference(Condition) ] ... ) ; # 0..* Why the care team exists
  fhir:managingOrganization  ( [ Reference(Organization) ] ... ) ; # 0..* Organization responsible for the care team
  fhir:telecom  ( [ ContactPoint ] ... ) ; # 0..* A contact detail for the care team (that applies to all members)
  fhir:note  ( [ Annotation ] ... ) ; # 0..* Comments made about the CareTeam

]

Changes since Release 3 from both R4 and R4B

CareTeam
CareTeam.status CareTeam.participant.role
  • Change value set Max Cardinality changed from http://hl7.org/fhir/ValueSet/care-team-status * to http://hl7.org/fhir/ValueSet/care-team-status|4.0.1 1
CareTeam.encounter CareTeam.participant.coverage[x]
  • Added Element
CareTeam.participant.role CareTeam.reason
  • Max Cardinality changed from 1 to * Added Element
CareTeam.participant.member CareTeam.encounter
  • Type Reference: Added Target Type PractitionerRole Deleted (Avoid circular references since Encounter references CareTeam)
CareTeam.telecom CareTeam.participant.period
  • Added Element Deleted
CareTeam.context CareTeam.reasonCode
  • deleted Deleted (-> CareTeam.reason)
CareTeam.reasonReference
  • Deleted (-> CareTeam.reason)

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

See R3 <--> R4 <--> R5 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and 1 r3 resources are invalid (0 errors). ) See Conversions Summary .)

 

See the Profiles & Extensions and the alternate Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis

Path Definition ValueSet Type Reference Documentation
CareTeam.status Indicates the status of the care team. CareTeamStatus Required CareTeamStatus

Indicates the status of the care team.

CareTeam.category Indicates the type of care team. CareTeamCategory Example CareTeamCategory

Indicates the type of care team.

CareTeam.participant.role Indicates specific responsibility of an individual within the care team, such as "Primary physician", "Team coordinator", "Caregiver", etc. ParticipantRoles Example ParticipantRoles

Roles of participants that may be included in a care team. Defined as: Healthcare professional (occupation) or Services (qualifier value).

CareTeam.reasonCode CareTeam.reason Indicates the reason for the care team. SNOMEDCTClinicalFindings Example SNOMEDCTClinicalFindings

This value set includes all the "Clinical finding" SNOMED CT icon codes - concepts where concept is-a 404684003 (Clinical finding (finding)).

id UniqueKey Level Location Description Expression
ctm-1 img  ctm-1 Rule CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists())) (member.resolve() is Practitioner)
img  ctm-2 Warning CareTeam.participant CareTeam.participant.role or CareTeam.participant.member exists role.exists() or member.exists()

The Provenance resource can be used for detailed review information, such as when the care team was last reviewed and by whom.

Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name Type Description Expression In Common
category token Type of team CareTeam.category
date date Time period team covers A date within the coverage time period. CareTeam.period 17 27 Resources
encounter identifier reference token Encounter created as part of External Ids for this team CareTeam.encounter ( Encounter ) CareTeam.identifier 65 Resources
identifier name token string External Ids for this Name of the team, such as crisis assessment team CareTeam.identifier CareTeam.name | CareTeam.extension('http://hl7.org/fhir/StructureDefinition/careteam-alias').value 30 Resources
participant reference Who is involved CareTeam.participant.member
( Practitioner , Organization , CareTeam , Patient , PractitionerRole , RelatedPerson )
patient reference Who care team is for CareTeam.subject.where(resolve() is Patient)
( Patient )
33 66 Resources
status token proposed | active | suspended | inactive | entered-in-error CareTeam.status
subject reference Who care team is for CareTeam.subject
( Group , Patient )