haau3 FHIR Implementation Guide (HFIG)
1.0.0 - ci-build
haau3 FHIR Implementation Guide (HFIG) - Local Development build (v1.0.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Official URL: https://haau3.com/fhir/StructureDefinition/haau3-care-team | Version: 1.0.0 | |||
| Draft as of 2026-10-14 | Computable Name: Haau3CareTeam | |||
A care team a health system recorded about a care recipient. The people on the team and the role each one holds are the source system's own. Every delivered record carries the identifier naming the source record it came from. A participant may state that its member is unknown, when the source named a role but not who fills it, or named someone whose record was not delivered.
Usages:
You can also check for usages in the FHIR IG Statistics
Description of Profiles, Differentials, Snapshots and how the different presentations work.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored | |
![]() ![]() |
1..* | Identifier | External Ids for this team | |
![]() ![]() |
0..1 | code | (USCDI) proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates whether the team is current , represents future intentions or is now a historical record. | |
![]() ![]() |
1..1 | Reference(US Core Patient Profile) | (USCDI) Who care team is for | |
![]() ![]() |
C | 1..* | BackboneElement | (USCDI) Members of the team Constraints: ctm-1 |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |
![]() ![]() ![]() |
1..1 | CodeableConcept | (USCDI) Type of involvement Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc. | |
![]() ![]() ![]() |
1..1 | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile | US Core PractitionerRole Profile | US Core CareTeam Profile | US Core RelatedPerson Profile ) | (USCDI) Who is involved | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.status | Base | required | CareTeamStatus | 📦4.0.1 | FHIR Std. |
| CareTeam.participant.role | Base | extensible |
Care Team Member Function
|
📦20190418 | VSAC v0.11 |
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | 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()))
|
| dom-2 | error | CareTeam | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CareTeam | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CareTeam | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from USCoreCareTeam
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |
![]() ![]() |
1..* | Identifier | External Ids for this team | |
Documentation for this format | ||||
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |||||
![]() ![]() |
0..1 | id | Logical id of this artifact | |||||
![]() ![]() |
0..1 | Meta | Metadata about the resource | |||||
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored | |||||
![]() ![]() |
1..* | Identifier | External Ids for this team | |||||
![]() ![]() |
0..1 | code | (USCDI) proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates whether the team is current , represents future intentions or is now a historical record. | |||||
![]() ![]() |
0..* | CodeableConcept | Type of team Binding: CareTeamCategory (example): Indicates the type of care team. | |||||
![]() ![]() |
0..1 | string | Name of the team, such as crisis assessment team | |||||
![]() ![]() |
1..1 | Reference(US Core Patient Profile) | (USCDI) Who care team is for | |||||
![]() ![]() |
0..1 | Reference(Encounter) | Encounter created as part of | |||||
![]() ![]() |
0..1 | Period | Time period team covers | |||||
![]() ![]() |
C | 1..* | BackboneElement | (USCDI) Members of the team Constraints: ctm-1 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
![]() ![]() ![]() |
1..1 | CodeableConcept | (USCDI) Type of involvement Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc. | |||||
![]() ![]() ![]() |
1..1 | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile | US Core PractitionerRole Profile | US Core CareTeam Profile | US Core RelatedPerson Profile ) | (USCDI) Who is involved | |||||
![]() ![]() ![]() |
0..1 | Reference(Organization) | Organization of the practitioner | |||||
![]() ![]() ![]() |
0..1 | Period | Time period of participant | |||||
![]() ![]() |
0..* | CodeableConcept | Why the care team exists Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team. | |||||
![]() ![]() |
0..* | Reference(Condition) | Why the care team exists | |||||
![]() ![]() |
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 | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std. |
| CareTeam.status | Base | required | CareTeamStatus | 📦4.0.1 | FHIR Std. |
| CareTeam.category | Base | example | Care Team category | 📦4.0.1 | FHIR Std. |
| CareTeam.participant.role | Base | extensible |
Care Team Member Function
|
📦20190418 | VSAC v0.11 |
| CareTeam.reasonCode | Base | example | SNOMED CT Clinical Findings | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | 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()))
|
| dom-2 | error | CareTeam | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CareTeam | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CareTeam | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from USCoreCareTeam
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored | |
![]() ![]() |
1..* | Identifier | External Ids for this team | |
![]() ![]() |
0..1 | code | (USCDI) proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates whether the team is current , represents future intentions or is now a historical record. | |
![]() ![]() |
1..1 | Reference(US Core Patient Profile) | (USCDI) Who care team is for | |
![]() ![]() |
C | 1..* | BackboneElement | (USCDI) Members of the team Constraints: ctm-1 |
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |
![]() ![]() ![]() |
1..1 | CodeableConcept | (USCDI) Type of involvement Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc. | |
![]() ![]() ![]() |
1..1 | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile | US Core PractitionerRole Profile | US Core CareTeam Profile | US Core RelatedPerson Profile ) | (USCDI) Who is involved | |
Documentation for this format | ||||
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.status | Base | required | CareTeamStatus | 📦4.0.1 | FHIR Std. |
| CareTeam.participant.role | Base | extensible |
Care Team Member Function
|
📦20190418 | VSAC v0.11 |
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | 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()))
|
| dom-2 | error | CareTeam | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CareTeam | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CareTeam | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Differential View
This structure is derived from USCoreCareTeam
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() |
|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |
![]() ![]() |
1..* | Identifier | External Ids for this team | |
Documentation for this format | ||||
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() | ||||
|---|---|---|---|---|---|---|---|---|
![]() |
0..* | USCoreCareTeam(6.1.0) | Planned participants in the coordination and delivery of care for a patient or group | |||||
![]() ![]() |
0..1 | id | Logical id of this artifact | |||||
![]() ![]() |
0..1 | Meta | Metadata about the resource | |||||
![]() ![]() |
0..1 | uri | A set of rules under which this content was created | |||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() |
0..* | Extension | Extensions that cannot be ignored | |||||
![]() ![]() |
1..* | Identifier | External Ids for this team | |||||
![]() ![]() |
0..1 | code | (USCDI) proposed | active | suspended | inactive | entered-in-error Binding: CareTeamStatus (required): Indicates whether the team is current , represents future intentions or is now a historical record. | |||||
![]() ![]() |
0..* | CodeableConcept | Type of team Binding: CareTeamCategory (example): Indicates the type of care team. | |||||
![]() ![]() |
0..1 | string | Name of the team, such as crisis assessment team | |||||
![]() ![]() |
1..1 | Reference(US Core Patient Profile) | (USCDI) Who care team is for | |||||
![]() ![]() |
0..1 | Reference(Encounter) | Encounter created as part of | |||||
![]() ![]() |
0..1 | Period | Time period team covers | |||||
![]() ![]() |
C | 1..* | BackboneElement | (USCDI) Members of the team Constraints: ctm-1 | ||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||
![]() ![]() ![]() |
0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||
![]() ![]() ![]() |
1..1 | CodeableConcept | (USCDI) Type of involvement Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc. | |||||
![]() ![]() ![]() |
1..1 | Reference(US Core Practitioner Profile | US Core Organization Profile | US Core Patient Profile | US Core PractitionerRole Profile | US Core CareTeam Profile | US Core RelatedPerson Profile ) | (USCDI) Who is involved | |||||
![]() ![]() ![]() |
0..1 | Reference(Organization) | Organization of the practitioner | |||||
![]() ![]() ![]() |
0..1 | Period | Time period of participant | |||||
![]() ![]() |
0..* | CodeableConcept | Why the care team exists Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team. | |||||
![]() ![]() |
0..* | Reference(Condition) | Why the care team exists | |||||
![]() ![]() |
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 | ||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| CareTeam.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std. |
| CareTeam.status | Base | required | CareTeamStatus | 📦4.0.1 | FHIR Std. |
| CareTeam.category | Base | example | Care Team category | 📦4.0.1 | FHIR Std. |
| CareTeam.participant.role | Base | extensible |
Care Team Member Function
|
📦20190418 | VSAC v0.11 |
| CareTeam.reasonCode | Base | example | SNOMED CT Clinical Findings | 📦4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ctm-1 | error | 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()))
|
| dom-2 | error | CareTeam | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CareTeam | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CareTeam | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CareTeam | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
This structure is derived from USCoreCareTeam
Other representations of profile: CSV, Excel, Schematron