This
page
is
part
of
the
FHIR
Specification
v6.0.0-ballot3:
Release
6
Ballot
(3rd
Draft)
(see
Ballot
Notes
).
The
current
version
is
5.0.0
.
For
a
full
list
Continuous
Integration
Build
of
available
versions,
see
FHIR
(will
be
incorrect/inconsistent
at
times).
See
the
Directory
of
published
versions
Responsible
Owner:
Patient
Care
Work
Group
|
|
Security Category : Patient | Compartments : Group , Patient , Practitioner , RelatedPerson |
The Care Team includes all the people, organizations, and care teams who participate or plan to participate in the coordination and delivery of care.
The CareTeam includes all the people, organizations, and care teams who participate or plan to participate in the coordination and delivery of care and is assigned to:
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 of care, an encounter, or may reflect all known team members across these perspectives. A 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.
the
Group
resource.
The
Group
resource
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.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
|---|---|---|---|---|
|
|
DomainResource |
Planned
participants
in
the
coordination
and
delivery
of
care
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
External
Ids
for
this
team
|
|
?! Σ | 0..1 | code |
proposed
|
active
|
suspended
|
inactive
|
entered-in-error
Binding: Care Team Status ( Required ) |
|
Σ | 0..* | CodeableConcept |
Type
of
team
Binding: Care Team category ( Example ) |
|
Σ | 0..1 | string |
Name
of
the
team,
such
as
crisis
assessment
team
|
|
Σ | 0..1 | Reference ( Patient | Group ) |
Who
care
team
is
for
|
|
Σ | 0..1 | Period |
Time
period
team
covers
|
|
C | 0..* | BackboneElement |
Members
of
the
team
+ Warning: CareTeam.participant.role or CareTeam.participant.member exists |
|
Σ C | 0..1 | CodeableConcept |
Type
of
involvement
Binding: Participant Roles ( Example ) |
|
Σ C | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group | HealthcareService ) |
Who
is
involved
|
|
Σ | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group | HealthcareService ) |
Entity
that
the
participant
is
acting
as
a
proxy
of,
or
an
agent
of,
or
in
the
interest
of,
or
as
a
representative
of
|
|
0..1 |
When
the
member
is
generally
available
within
this
care
team
|
||
|
Period | |||
|
Timing | |||
| Σ | 0..* | Reference ( Any ) |
Basis
for
the
member's
participation
|
![]() ![]() |
0..* | CodeableReference ( Condition ) |
Why
the
care
team
exists
Binding: SNOMED CT Clinical Findings ( Example ) |
|
|
Σ | 0..* | Reference ( Organization ) |
Organization
responsible
for
the
care
team
|
|
0..* | ContactPoint |
A
contact
detail
for
the
care
team
(that
applies
to
all
members)
|
|
|
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> <| </onBehalfOf><member><!-- I 0..1 Reference(CareTeam|Group|HealthcareService|Organization| Patient|Practitioner|PractitionerRole|RelatedPerson) Who is involved --></member> <onBehalfOf><!-- 0..1 Reference(CareTeam|Group|HealthcareService|Organization| Patient|Practitioner|PractitionerRole|RelatedPerson) Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of --></onBehalfOf> <effective[x]><!-- 0..1 Period|Timing When the member is generally available within this care team --></effective[x]> <supportingInfo><!-- 0..* Reference(Any) Basis for the member's participation --></supportingInfo> </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|Group|HealthcareService|Organization|
Patient|Practitioner|PractitionerRole|RelatedPerson) }, // I Who is involved
"onBehalfOf" : { Reference(CareTeam|Group|HealthcareService|Organization|
Patient|Practitioner|PractitionerRole|RelatedPerson) }, // Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of
// effective[x]: When the member is generally available within this care team. One of these 2:
"effectivePeriod" : { Period },
" }
"effectiveTiming" : { Timing },
"supportingInfo" : [{ Reference(Any) }] // Basis for the member's participation
}],
"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 # from# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir: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 involvementfhir: fhir:fhir:member [ Reference(CareTeam|Group|HealthcareService|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved fhir:onBehalfOf [ Reference(CareTeam|Group|HealthcareService|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) ] ; # 0..1 Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of # effective[x] : 0..1 When the member is generally available within this care team. One of these 2 fhir:effective [ a fhir:Period ; Period ] fhir:effective [ a fhir:Timing ; Timing ] fhir:supportingInfo ( [ Reference(Any) ] ... ) ; # 0..* Basis for the member's participation ] ... ) ; 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 |
|
| CareTeam.participant.member |
|
| CareTeam.participant.onBehalfOf |
|
| CareTeam.participant.effective[x] |
|
| CareTeam.participant.supportingInfo |
|
| CareTeam.reason |
|
| CareTeam.encounter |
|
| CareTeam.participant.period |
|
| CareTeam.reasonCode |
|
| CareTeam.reasonReference |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
Filter:
|
|---|---|---|---|---|
|
|
DomainResource |
Planned
participants
in
the
coordination
and
delivery
of
care
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
External
Ids
for
this
team
|
|
?! Σ | 0..1 | code |
proposed
|
active
|
suspended
|
inactive
|
entered-in-error
Binding: Care Team Status ( Required ) |
|
Σ | 0..* | CodeableConcept |
Type
of
team
Binding: Care Team category ( Example ) |
|
Σ | 0..1 | string |
Name
of
the
team,
such
as
crisis
assessment
team
|
|
Σ | 0..1 | Reference ( Patient | Group ) |
Who
care
team
is
for
|
|
Σ | 0..1 | Period |
Time
period
team
covers
|
|
C | 0..* | BackboneElement |
Members
of
the
team
+ Warning: CareTeam.participant.role or CareTeam.participant.member exists |
|
Σ C | 0..1 | CodeableConcept |
Type
of
involvement
Binding: Participant Roles ( Example ) |
|
Σ C | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group | HealthcareService ) |
Who
is
involved
|
|
Σ | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group | HealthcareService ) |
Entity
that
the
participant
is
acting
as
a
proxy
of,
or
an
agent
of,
or
in
the
interest
of,
or
as
a
representative
of
|
|
0..1 |
When
the
member
is
generally
available
within
this
care
team
|
||
|
Period | |||
|
Timing | |||
| Σ | 0..* | Reference ( Any ) |
Basis
for
the
member's
participation
|
![]() ![]() |
0..* | CodeableReference ( Condition ) |
Why
the
care
team
exists
Binding: SNOMED CT Clinical Findings ( Example ) |
|
|
Σ | 0..* | Reference ( Organization ) |
Organization
responsible
for
the
care
team
|
|
0..* | ContactPoint |
A
contact
detail
for
the
care
team
(that
applies
to
all
members)
|
|
|
0..* | Annotation |
Comments
made
about
the
CareTeam
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
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> <| </onBehalfOf><member><!-- I 0..1 Reference(CareTeam|Group|HealthcareService|Organization| Patient|Practitioner|PractitionerRole|RelatedPerson) Who is involved --></member> <onBehalfOf><!-- 0..1 Reference(CareTeam|Group|HealthcareService|Organization| Patient|Practitioner|PractitionerRole|RelatedPerson) Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of --></onBehalfOf> <effective[x]><!-- 0..1 Period|Timing When the member is generally available within this care team --></effective[x]> <supportingInfo><!-- 0..* Reference(Any) Basis for the member's participation --></supportingInfo> </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|Group|HealthcareService|Organization|
Patient|Practitioner|PractitionerRole|RelatedPerson) }, // I Who is involved
"onBehalfOf" : { Reference(CareTeam|Group|HealthcareService|Organization|
Patient|Practitioner|PractitionerRole|RelatedPerson) }, // Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of
// effective[x]: When the member is generally available within this care team. One of these 2:
"effectivePeriod" : { Period },
" }
"effectiveTiming" : { Timing },
"supportingInfo" : [{ Reference(Any) }] // Basis for the member's participation
}],
"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 # from# from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir: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 involvementfhir: fhir:fhir:member [ Reference(CareTeam|Group|HealthcareService|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved fhir:onBehalfOf [ Reference(CareTeam|Group|HealthcareService|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) ] ; # 0..1 Entity that the participant is acting as a proxy of, or an agent of, or in the interest of, or as a representative of # effective[x] : 0..1 When the member is generally available within this care team. One of these 2 fhir:effective [ a fhir:Period ; Period ] fhir:effective [ a fhir:Timing ; Timing ] fhir:supportingInfo ( [ Reference(Any) ] ... ) ; # 0..* Basis for the member's participation ] ... ) ; 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 |
|
| CareTeam.participant.member |
|
| CareTeam.participant.onBehalfOf |
|
| CareTeam.participant.effective[x] |
|
| CareTeam.participant.supportingInfo |
|
| CareTeam.reason |
|
| CareTeam.encounter |
|
| CareTeam.participant.period |
|
| CareTeam.reasonCode |
|
| CareTeam.reasonReference |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis
| 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
|
| UniqueKey | Level | Location | Description | Expression |
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 | A date within the coverage time period. |
|
|
| identifier | token | External Ids for this team | CareTeam.identifier |
|
| 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 , Group , Organization , CareTeam , Patient , HealthcareService , PractitionerRole , RelatedPerson ) |
|
| patient | reference | Who care team is for |
CareTeam.subject.where(resolve()
is
Patient)
( Patient ) |
|
| status | token | proposed | active | suspended | inactive | entered-in-error | CareTeam.status | |
| subject | reference | Who care team is for |
CareTeam.subject
( Group , Patient ) |