CareTeam
Work with FHIR R4 4.0.1 CareTeam resources.
Choose an operation for this resource:
- Search CareTeam
- Read CareTeam
- Read CareTeam Version
- Create CareTeam
- Update CareTeam
- Delete CareTeam
- Hard Delete CareTeam
- Purge Deleted CareTeam
The diagram summarizes CareTeam requests and responses. See Supported FHIR REST Interactions for the shared interaction model.
FHIR R4 definition: https://hl7.org/fhir/R4/careteam.html. See interaction response codes and common error responses.
The endpoint is /api/fhir/r4/CareTeam. Consult the live CapabilityStatement for supported capabilities. This resource is available on the R4 API.
Interactions and responses
- Resource lifecycle: create, read, versioned read, update, soft deletion and version preconditions.
- PUT-as-create and restoration: creation/restoration, server-managed metadata, response headers and return preferences.
- Interaction responses: success
statuscodes. - OperationOutcome errors: common errors and response bodies.
- Batch requests: independent entry processing.
| CareTeam capability | Support or requirement |
|---|---|
| Conditional create | Not supported. |
| Conditional update | Not supported. |
| Transaction bundles | Not supported. |
Content and validation
For shared validation-error responses, see OperationOutcome errors.
| CareTeam detail | Requirement or behavior |
|---|---|
| Resource rule | All CareTeam-specific fields are optional. |
| Status | When supplied, status is proposed, active, suspended, inactive or entered-in-error. |
| Patient references | A subject can reference Patient or Group. |
| Retained content | Participants preserve roles, member, onBehalfOf and period; onBehalfOf applies to a Practitioner member. |
| Contained resources | Primitive extensions, nested details and supported contained resources are preserved. |
| Write provenance | Successful changes generate Provenance. |
{"resourceType":"CareTeam","status":"active","name":"Synthetic care team","subject":{"reference":"Patient/synthetic-patient"},"participant":[{"role":[{"text":"Coordinator"}],"member":{"reference":"Practitioner/synthetic-practitioner"}}]}Search
- Search operation: endpoints, complete parameter table, supported forms and examples.
- Common Search Controls: shared controls and server-provided paging links.
- Value Types and Syntax and Comparators, Modifiers, and Chains: shared syntax. Use only the forms supported by this resource.
| CareTeam detail | Requirement or behavior |
|---|---|
| Patient references | Selected filters are _id, _lastUpdated, identifier, patient and status. |
| Patient references | The patient filter matches a Patient-valued subject; Group subjects do not match. |
| Patient references | Patient supports direct references and :identifier. |
| Limitations | Identifier and status accept one unmodified token in code, system|code, |code or system| form; repeated tokens, comma alternatives and token modifiers are unsupported. |
| Resource rule | The implicit system for status is http://hl7.org/fhir/care-team-status. |
| Date filters | _lastUpdated accepts up to two bounds combined with AND using eq, ne, gt, lt, ge, le, sa, eb and ap. |
| Limitations | Participant, role, encounter, clinician and organization filters, new chains, composites and full-text search are not supported. |
GET /api/fhir/r4/CareTeam?patient=Patient/synthetic-patient&status=active&_lastUpdated=ge2026-01-01&_lastUpdated=lt2027-01-01Authorization and permanent deletion
- Authentication and Scopes: bearer tokens, scope configuration and constrained access. Required resource scopes are listed on each operation page.
- Data Deletion and Purge Operations: permanent-deletion eligibility and additional permissions.
- Hard Delete and Purge Deleted: resource endpoints and required scopes; see also shared purge guidance.
| Item | Requirement or behavior |
|---|---|
| Resource constraints | Constraints support _id, _lastUpdated, identifier, patient (including :identifier) and status, including combined constraints. |