Skip to content

CareTeam resource (FHIR R4)

CareTeam is the FHIR R4 resource for the Care Team includes all the people and organizations who plan to participate in the coordination and delivery of care for a patient.

ResourceCareTeam
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/CareTeam
Required elementsnone; every top-level element is optional (min 0) in base R4
IG profiles in this catalog1

Example

{
  "resourceType": "CareTeam",
  "id": "careteam-af425b6cf22e11dbc0ee00a535127147",
  "status": "active",
  "name": "Care Team for Fuentes, Ola",
  "subject": {
    "reference": "Patient/patient-L46A6EIB9J"
  },
  "participant": [
    {
      "role": [
        {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "omitted",
              "display": "SNOMED CT code omitted from this published example"
            }
          ]
        }
      ],
      "member": {
        "display": "Dr. Primary Care Physician"
      }
    },
    {
      "role": [
        {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "omitted",
              "display": "SNOMED CT code omitted from this published example"
            }
          ]
        }
      ],
      "member": {
        "display": "Nurse Care Coordinator"
      }
    }
  ]
}

Generated by the Pidgeon engine: pidgeon generate CareTeam --seed 20260722. Codes from licensed terminologies (LOINC, SNOMED CT, CPT, RxNorm) are omitted from published examples.

Validation context

  • strict pidgeon validate grades a CareTeam instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
  • strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup CareTeam

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.