R6 Ballot (1st Draft)

This page is part of the FHIR Specification v6.0.0-ballot1: Release 6 Ballot (1st Draft) (see Ballot Notes). The current version is 5.0.0. For a full list of available versions, see the Directory of published versions

9.7 Resource CareTeam - Content

Patient Care icon

Work Group

Maturity Level: 2

Trial Use

Security Category: Patient

Compartments: Patient, Practitioner, RelatedPerson

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

9.7.1 Scope and Usage

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

a single patient, or
a group (such as a married couple in therapy or a support group), or
an event, prior to a subject being identified (such as a code blue team or emergency response 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.

9.7.2 Boundaries and Relationships

Care Team is distinct from Group. Group 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 participants within a 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.

9.7.3 References to this Resource

Structure

Name	Flags	Card.	Type	Description & Constraints
CareTeam	TU		DomainResource	Planned participants in the coordination and delivery of care 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 Binding: Care Team Status (Required)
category	Σ	0..*	CodeableConcept	Type of team Binding: Care Team category (Example)
name	Σ	0..1	string	Name of the team, such as crisis assessment team
subject	Σ	0..1	Reference(Patient \| Group)	Who care team is for
period	Σ	0..1	Period	Time period team covers
participant	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
coverage[x]		0..1		When the member is generally available within this care team
coveragePeriod			Period
coverageTiming			Timing
reason		0..*	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
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<CareTeam xmlns="http://hl7.org/fhir"> 
 <!-- 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><!-- 0..1 Reference(Group|Patient) Who care team is for --></subject>
 <period><!-- 0..1 Period Time period team covers --></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>
 <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>

JSON Template

{
  "resourceType" : "CareTeam",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External Ids for this team
  "status" : "<code>", // proposed | active | suspended | inactive | entered-in-error
  "category" : [{ CodeableConcept }], // Type of team
  "name" : "<string>", // Name of the team, such as crisis assessment team
  "subject" : { Reference(Group|Patient) }, // Who care team is for
  "period" : { Period }, // Time period team covers
  "participant" : [{ // Members of the team
    "role" : { CodeableConcept }, // I Type of involvement
    "member" : { Reference(CareTeam|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) }, // I Who is involved
    "onBehalfOf" : { Reference(Organization) }, // I Organization of the practitioner
    // coverage[x]: When the member is generally available within this care team. One of these 2:
    "coveragePeriod" : { Period },
    "coverageTiming" : { Timing }
  }],
  "reason" : [{ CodeableReference(Condition) }], // Why the care team exists
  "managingOrganization" : [{ Reference(Organization) }], // Organization responsible for the care team
  "telecom" : [{ ContactPoint }], // A contact detail for the care team (that applies to all members)
  "note" : [{ Annotation }] // Comments made about the CareTeam
}

Turtle Template

@prefix fhir: <http://hl7.org/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: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 from both R4 and R4B

CareTeam

CareTeam.participant.role

Max Cardinality changed from * to 1

CareTeam.participant.coverage[x]

Added Element

CareTeam.reason

Added Element

CareTeam.encounter

Deleted (Avoid circular references since Encounter references CareTeam)

CareTeam.participant.period

Deleted

CareTeam.reasonCode

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 R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

Structure

Name	Flags	Card.	Type	Description & Constraints
CareTeam	TU		DomainResource	Planned participants in the coordination and delivery of care 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 Binding: Care Team Status (Required)
category	Σ	0..*	CodeableConcept	Type of team Binding: Care Team category (Example)
name	Σ	0..1	string	Name of the team, such as crisis assessment team
subject	Σ	0..1	Reference(Patient \| Group)	Who care team is for
period	Σ	0..1	Period	Time period team covers
participant	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
coverage[x]		0..1		When the member is generally available within this care team
coveragePeriod			Period
coverageTiming			Timing
reason		0..*	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
Documentation for this format

See the Extensions for this resource

UML Diagram (Legend)

XML Template

<CareTeam xmlns="http://hl7.org/fhir"> 
 <!-- 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><!-- 0..1 Reference(Group|Patient) Who care team is for --></subject>
 <period><!-- 0..1 Period Time period team covers --></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>
 <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>

JSON Template

{
  "resourceType" : "CareTeam",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // External Ids for this team
  "status" : "<code>", // proposed | active | suspended | inactive | entered-in-error
  "category" : [{ CodeableConcept }], // Type of team
  "name" : "<string>", // Name of the team, such as crisis assessment team
  "subject" : { Reference(Group|Patient) }, // Who care team is for
  "period" : { Period }, // Time period team covers
  "participant" : [{ // Members of the team
    "role" : { CodeableConcept }, // I Type of involvement
    "member" : { Reference(CareTeam|Organization|Patient|Practitioner|
    PractitionerRole|RelatedPerson) }, // I Who is involved
    "onBehalfOf" : { Reference(Organization) }, // I Organization of the practitioner
    // coverage[x]: When the member is generally available within this care team. One of these 2:
    "coveragePeriod" : { Period },
    "coverageTiming" : { Timing }
  }],
  "reason" : [{ CodeableReference(Condition) }], // Why the care team exists
  "managingOrganization" : [{ Reference(Organization) }], // Organization responsible for the care team
  "telecom" : [{ ContactPoint }], // A contact detail for the care team (that applies to all members)
  "note" : [{ Annotation }] // Comments made about the CareTeam
}

Turtle Template

@prefix fhir: <http://hl7.org/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: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 from both R4 and R4B

CareTeam

CareTeam.participant.role

Max Cardinality changed from * to 1

CareTeam.participant.coverage[x]

Added Element

CareTeam.reason

Added Element

CareTeam.encounter

Deleted (Avoid circular references since Encounter references CareTeam)

CareTeam.participant.period

Deleted

CareTeam.reasonCode

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 R4 <--> R5 Conversion Maps (status = See Conversions Summary.)

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

9.7.4.1 Terminology Bindings

Path	ValueSet	Type	Documentation
CareTeam.status	CareTeamStatus	Required	Indicates the status of the care team.
CareTeam.category	CareTeamCategory	Example	Indicates the type of care team.
CareTeam.participant.role	ParticipantRoles	Example	Roles of participants that may be included in a care team. Defined as: Healthcare professional (occupation) or Services (qualifier value).
CareTeam.reason	SNOMEDCTClinicalFindings	Example	This value set includes all the "Clinical finding" SNOMED CT codes - concepts where concept is-a 404684003 (Clinical finding (finding)).

Path

ValueSet

Type

Documentation

CareTeam.status

CareTeamStatus

Required

Indicates the status of the care team.

CareTeam.category

CareTeamCategory

Example

Indicates the type of care team.

CareTeam.participant.role

ParticipantRoles

Example

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

CareTeam.reason

SNOMEDCTClinicalFindings

Example

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

9.7.4.2 Constraints

UniqueKey

Level

Location

Description

Expression

ctm-1

Rule

CareTeam.participant

CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner

onBehalfOf.exists() implies (member.resolve() is Practitioner)

ctm-2

Warning

CareTeam.participant

CareTeam.participant.role or CareTeam.participant.member exists

role.exists() or member.exists()

9.7.4.3 Notes

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

9.7.5 Search Parameters

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	A date within the coverage time period.		26 Resources
identifier	token	External Ids for this team	CareTeam.identifier	65 Resources
name	string	Name of the team, such as crisis assessment team	CareTeam.name \| CareTeam.extension('http://hl7.org/fhir/StructureDefinition/careteam-alias').value
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)	66 Resources
status	token	proposed \| active \| suspended \| inactive \| entered-in-error	CareTeam.status
subject	reference	Who care team is for	CareTeam.subject (Group, Patient)