API Name: put-careplan


This API creates or updates a Care Plan record describing how one or more practitioners intend to deliver care for a particular patient over a specified period. The care plan may reference conditions being addressed, goals, care team members, and activity progress notes.

Specification


Endpoint [baseurl]/CarePlan/$put-careplan
Protocol HTTPS
HTTP Method Post
HTTP Header Content-Type: application/fhir+json

Request Body

Remarks:

  • This is a type-level operation that operates on the CarePlan resource type.
  • The request body contains a single CarePlan resource with contained CareTeam and Goal resources.
  • CarePlan.careTeam must reference a contained CareTeam resource (e.g., "reference": "#careteam-001").
  • CarePlan.goal must reference contained Goal resources (e.g., "reference": "#goal-001").
  • (All Slices) is an automatically generated section and should be ignored. Do not pass this as an input parameter. It will also not be part of response.

CarePlan

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
identifierΣ C1..1Identifier
instantiatesCanonicalΣ0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUriΣ0..0uri
basedOnΣ C0..0Reference(CarePlan | NutritionOrder | RequestOrchestration | ServiceRequest)
replacesΣ C0..0Reference(CarePlan)
partOfΣ C0..0Reference(CarePlan)
statusΣ ?!1..1codeBinding
intentΣ ?!1..1codeBinding
categoryΣ0..*CodeableConcept
titleΣ0..0string
descriptionΣ0..0string
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBindingFixed Value
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..1string
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..0string
periodΣ C0..1Period
createdΣ0..0dateTime
custodianΣ C0..0Reference(CareTeam | Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..1string
id0..0string
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ C0..0Identifier
displayΣ C0..0string
id0..0string
extensionC0..0Extension
conceptΣ0..0CodeableConcept
referenceΣ C1..1Reference
supportingInfoC0..0Reference(Resource)
id0..0string
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ C0..0Identifier
displayΣ C0..0string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0string
extensionC0..0Extension
conceptΣ1..1CodeableConcept
referenceΣ C0..0Reference
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
identifierΣ C1..1Identifier
displayΣ C0..1string
timeΣ1..1dateTime
textΣ1..1markdown
plannedActivityReferenceC0..1Reference(Appointment | CommunicationRequest | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | RequestOrchestration | ServiceRequest | SupplyRequest | Task | VisionPrescription)
note0..*Annotation
{
"resourceType": "CarePlan",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-careplan"
]
},
{
"resourceType": "CareTeam",
"id": "careteam-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-careteam"
]
},
"status": "active",
"name": "Chronic Disease Management Team",
{
"member": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
}
},
{
"member": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "N98765"
},
"display": "Nurse Mei Ling"
}
}
]
},
{
"resourceType": "Goal",
"id": "goal-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-goal"
]
},
"lifecycleStatus": "active",
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/goal-achievement",
"code": "in-progress",
"display": "In Progress"
}
]
},
"coding": [
{
"system": "http://snomed.info/sct",
"code": "313835004",
"display": "Diabetic control"
}
],
"text": "Achieve HbA1c below 7% within 6 months"
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S9234567B"
}
},
"startDate": "2026-02-01",
"target": [
{
"measure": {
"coding": [
{
"system": "http://loinc.org",
"code": "4548-4",
"display": "Hemoglobin A1c/Hemoglobin.total in Blood"
}
]
},
"value": 7,
"comparator": "<",
"unit": "%",
"system": "http://unitsofmeasure.org",
"code": "%"
},
"dueDate": "2026-07-31"
}
],
"note": [
{
"text": "Target HbA1c reduction from baseline 9.2% to below 7% through lifestyle modification and medication compliance"
}
]
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "CP-2026-001234"
}
],
"status": "active",
"intent": "plan",
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/careplan-category",
"code": "assess-plan",
"display": "Assessment and Plan of Treatment"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S9234567B"
}
},
"type": "Encounter",
"system": "https://fhir.synapxe.sg/NamingSystem/eventID",
"value": "ENC-2026-04567"
}
},
"period": {
"start": "2026-02-01",
"end": "2026-07-31"
},
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
}
],
{
"reference": "#careteam-001"
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "COND-2026-00456"
},
"display": "Type 2 Diabetes Mellitus"
}
}
],
"goal": [
{
"reference": "#goal-001"
}
],
{
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "229070002",
"display": "Diabetes mellitus education"
}
],
"text": "Diabetes management education session"
}
}
],
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
},
"time": "2026-02-20T10:00:00+08:00",
"text": "Patient completed initial diabetes education session. HbA1c monitoring plan established. Patient was counselled on dietary modifications and home glucose monitoring."
}
]
}
],
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
},
"time": "2026-02-20T10:00:00+08:00",
"text": "Patient is a newly diagnosed type 2 diabetic. Comprehensive care plan established focusing on lifestyle modification, medication management, and regular monitoring. Patient motivated and compliant."
}
]
}

Successful Response

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
identifierΣ C1..1Identifier
instantiatesCanonicalΣ0..0canonical(ActivityDefinition | Measure | OperationDefinition | PlanDefinition | Questionnaire)
instantiatesUriΣ0..0uri
basedOnΣ C0..0Reference(CarePlan | NutritionOrder | RequestOrchestration | ServiceRequest)
replacesΣ C0..0Reference(CarePlan)
partOfΣ C0..0Reference(CarePlan)
statusΣ ?!1..1codeBinding
intentΣ ?!1..1codeBinding
categoryΣ0..*CodeableConcept
titleΣ0..0string
descriptionΣ0..0string
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBindingFixed Value
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..1string
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..0string
periodΣ C0..1Period
createdΣ0..0dateTime
custodianΣ C0..0Reference(CareTeam | Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson)
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
displayΣ C0..1string
id0..0string
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ C0..0Identifier
displayΣ C0..0string
id0..0string
extensionC0..0Extension
conceptΣ0..0CodeableConcept
referenceΣ C1..1Reference
supportingInfoC0..0Reference(Resource)
id0..0string
extensionC0..0Extension
referenceΣ C1..1string
typeΣ0..0uriBinding
identifierΣ C0..0Identifier
displayΣ C0..0string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0string
extensionC0..0Extension
conceptΣ1..1CodeableConcept
referenceΣ C0..0Reference
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
referenceΣ C0..0string
typeΣ1..1uriBinding
identifierΣ C1..1Identifier
displayΣ C0..1string
timeΣ1..1dateTime
textΣ1..1markdown
plannedActivityReferenceC0..1Reference(Appointment | CommunicationRequest | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | RequestOrchestration | ServiceRequest | SupplyRequest | Task | VisionPrescription)
note0..*Annotation
{
"resourceType": "CarePlan",
"id": "cp-2026-001234",
"meta": {
"versionId": "1",
"lastUpdated": "2026-02-20T10:00:00.1+08:00",
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-careplan"
]
},
{
"resourceType": "CareTeam",
"id": "careteam-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-careteam"
]
},
"status": "active",
"name": "Chronic Disease Management Team",
{
"member": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
}
},
{
"member": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "N98765"
},
"display": "Nurse Mei Ling"
}
}
]
},
{
"resourceType": "Goal",
"id": "goal-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-goal"
]
},
"lifecycleStatus": "active",
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/goal-achievement",
"code": "in-progress",
"display": "In Progress"
}
]
},
"coding": [
{
"system": "http://snomed.info/sct",
"code": "313835004",
"display": "Diabetic control"
}
],
"text": "Achieve HbA1c below 7% within 6 months"
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S9234567B"
}
},
"startDate": "2026-02-01",
"target": [
{
"measure": {
"coding": [
{
"system": "http://loinc.org",
"code": "4548-4",
"display": "Hemoglobin A1c/Hemoglobin.total in Blood"
}
]
},
"value": 7,
"comparator": "<",
"unit": "%",
"system": "http://unitsofmeasure.org",
"code": "%"
},
"dueDate": "2026-07-31"
}
],
"note": [
{
"text": "Target HbA1c reduction from baseline 9.2% to below 7% through lifestyle modification and medication compliance"
}
]
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "CP-2026-001234"
}
],
"status": "active",
"intent": "plan",
{
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/careplan-category",
"code": "assess-plan",
"display": "Assessment and Plan of Treatment"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S9234567B"
}
},
"type": "Encounter",
"system": "https://fhir.synapxe.sg/NamingSystem/eventID",
"value": "ENC-2026-04567"
}
},
"period": {
"start": "2026-02-01",
"end": "2026-07-31"
},
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
}
],
{
"reference": "#careteam-001"
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "COND-2026-00456"
},
"display": "Type 2 Diabetes Mellitus"
}
}
],
"goal": [
{
"reference": "#goal-001"
}
],
{
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "229070002",
"display": "Diabetes mellitus education"
}
],
"text": "Diabetes management education session"
}
}
],
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
},
"time": "2026-02-20T10:00:00+08:00",
"text": "Patient completed initial diabetes education session. HbA1c monitoring plan established. Patient was counselled on dietary modifications and home glucose monitoring."
}
]
}
],
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M23456"
},
"display": "Dr. Rajesh Kumar"
},
"time": "2026-02-20T10:00:00+08:00",
"text": "Patient is a newly diagnosed type 2 diabetic. Comprehensive care plan established focusing on lifestyle modification, medication management, and regular monitoring. Patient motivated and compliant."
}
]
}

Business Level Errors


This section details the business level errors exposed by OperationOutcome resource for this operation. Refer to API Error Handling for framework level errors.

For illustration only

http status code code details.coding.code details.text
404 not-found E-10000 No matching patient found based on NRIC, Date of Birth and Gender
404 not-found E-10001 Institution code for organization is not found
404 not-found E-10002 Organization code is not found
400 business-rule E-10003 Patient is not currently enrolled to the organization
400 duplicate E-10004 An attempt was made to create a duplicate record
400 invalid E-10005 Invalid care plan identifier
400 invalid E-10006 Invalid care plan status