Clinical
Summary
This
page
is
part
of
the
FHIR
Specification
(v5.0.0:
R5
-
STU
v6.0.0-ballot3:
Release
6
Ballot
(3rd
Draft)
(see
Ballot
Notes
).
This
is
the
The
current
published
version
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
|
Patient
Care
Work
Group
|
Maturity Level : 2 | Trial Use | Security Category : Patient | Compartments : Group , Patient , Practitioner , RelatedPerson |
The
Care
Team
includes
all
the
people
people,
organizations,
and
organizations
care
teams
who
participate
or
plan
to
participate
in
the
coordination
and
delivery
of
care.
The
CareTeam
includes
all
the
people
people,
organizations,
and
organizations
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,
episode
of
care,
an
encounter,
or
may
reflect
all
known
team
members
across
these
perspectives.
An
individual's
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. 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.
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
|
role
|
Σ C | 0..1 | CodeableConcept |
Type
of
involvement
Binding: Participant Roles ( Example ) |
|
member
|
Σ C | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group ) |
Who
is
involved
|
|
onBehalfOf
|
Σ
|
0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group ) |
|
|
0..1 |
When
the
member
is
generally
available
within
this
care
team
|
||
|
Period | |||
|
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|Group|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who is involved --></member><</onBehalfOf> <</coverage[x]><onBehalfOf><!-- 0..1 Reference(CareTeam|Group|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]> </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" : "",
"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|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // I Who is involved
"onBehalfOf" : { Reference(CareTeam|Group|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 }
}],
"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:;[ 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 involvementfhir: fhir: # . One of these 2 fhir: ] fhir: ]fhir:member [ Reference(CareTeam|Group|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved fhir:onBehalfOf [ Reference(CareTeam|Group|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: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.effective[x] |
|
| 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
|
|---|---|---|---|---|
|
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
|
|
role
|
Σ C | 0..1 | CodeableConcept |
Type
of
involvement
Binding: Participant Roles ( Example ) |
|
member
|
Σ C | 0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group ) |
Who
is
involved
|
|
onBehalfOf
|
Σ
|
0..1 | Reference ( Practitioner | PractitionerRole | RelatedPerson | Patient | Organization | CareTeam | Group ) |
|
|
|
0..1 |
When
the
member
is
generally
available
within
this
care
team
|
||
|
|
Period | |||
|
|
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
XML Template
<<CareTeam xmlns="http://hl7.org/fhir"><|<member><!-- I 0..1 Reference(CareTeam|Group|Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who is involved --></member><</onBehalfOf> <</coverage[x]><onBehalfOf><!-- 0..1 Reference(CareTeam|Group|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]> </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" : "",
"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|Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // I Who is involved
"onBehalfOf" : { Reference(CareTeam|Group|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 }
}],
"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:;[ 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 involvementfhir: fhir: # . One of these 2 fhir: ] fhir: ]fhir:member [ Reference(CareTeam|Group|Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 I Who is involved fhir:onBehalfOf [ Reference(CareTeam|Group|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: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.effective[x] |
|
| 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 |
|
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 , 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 ) |
FHIR
®©
HL7.org
2011+.
FHIR
R5
hl7.fhir.core#5.0.0
R6
hl7.fhir.core#6.0.0-ballot3
generated
on
Sun,
Mar
26,
2023
15:24+1100.
Tue,
Apr
1,
2025
12:24+1100.
Links:
Search
|
Version
History
|
Contents
|
Glossary
|
QA
|
Compare
to
R4
|
Compare
to
R4B
R5
|
|
Propose
a
change