API Name: put-patient-problem-list


This API creates or updates the Patient Problem List record, which curates a collection of clinical problems (conditions) for a patient. The list is typically reviewed and maintained during clinical encounters to track active and resolved health issues.

Specification


Endpoint [baseurl]/List/$put-patient-problem-list
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 List resource type.
  • The request body contains a single List resource with contained Condition (Problem) resources.
  • (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.

ProblemList

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
contextC0..1Extension(CodeableConcept)
statusReasonC0..1Extension(CodeableConcept)
modifierExtensionΣ ?! C0..*Extension
identifierC0..*Identifier
statusΣ ?!1..1codeBinding
modeΣ ?!1..1codeBindingFixed Value
titleΣ0..0string
codeΣ1..1CodeableConcept
subjectΣ C0..*Reference(Patient)
encounterC0..1Reference(Encounter)
dateΣ0..0dateTime
sourceΣ C0..1Reference(Organization)
orderedBy0..0CodeableConceptBinding
note0..1Annotation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
flag0..0CodeableConcept
deleted?!0..0boolean
date0..0dateTime
itemC1..1Reference(Problem)
emptyReasonC0..0CodeableConceptBinding
{
"resourceType": "List",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-list-problem"
]
},
{
"resourceType": "Condition",
"id": "problem-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-problem"
]
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-healthDomain",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-serviceSpeciality",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/department-specialty",
"code": "PGN",
"display": "Paediatric Genetics"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-conditionType",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/condition-type",
"code": "primary",
"display": "Primary"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/sequence-no",
"value": "SEQ-PROB-001"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
],
"coding": [
{
"system": "http://snomed.info/sct",
"code": "24484000",
"display": "Severe"
}
]
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "15776009",
"display": "Pancreatic structure"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"onsetDateTime": "2024-06-15T00:00:00+08:00",
"recordedDate": "2024-06-15T10:30:00+08:00",
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "author",
"display": "Author"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
}
}
],
"stage": [
{
"summary": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "786005",
"display": "Clinical stage I"
}
]
}
}
],
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
},
"time": "2024-06-15T10:30:00+08:00",
"text": "Patient diagnosed with Type 2 Diabetes Mellitus. Started on Metformin 500mg BD. HbA1c at diagnosis: 8.2%. Target HbA1c < 7%."
}
]
},
{
"resourceType": "Condition",
"id": "problem-002",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-problem"
]
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-healthDomain",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-serviceSpeciality",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/department-specialty",
"code": "PGN",
"display": "Paediatric Genetics"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-conditionType",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/condition-type",
"code": "secondary",
"display": "Secondary"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/sequence-no",
"value": "SEQ-PROB-002"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
],
"coding": [
{
"system": "http://snomed.info/sct",
"code": "6736007",
"display": "Moderate"
}
]
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "38341003",
"display": "Hypertensive disorder"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "80891009",
"display": "Heart structure"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"value": 55,
"unit": "years",
"system": "http://unitsofmeasure.org",
"code": "a"
},
"abatementDateTime": "2026-01-20T00:00:00+08:00",
"recordedDate": "2023-03-10T14:00:00+08:00",
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "author",
"display": "Author"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M67890"
},
"display": "Dr. Michael Tan"
}
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "informant",
"display": "Informant"
}
]
},
"actor": {
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
}
],
"note": [
{
"authorString": "Dr. Michael Tan",
"time": "2023-03-10T14:00:00+08:00",
"text": "Essential hypertension diagnosed during routine health screening. Currently managed with Amlodipine 5mg OD. Blood pressure well controlled at last visit (128/78 mmHg)."
}
]
}
],
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-context",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/clinical-setting",
"code": "admission",
"display": "Admission"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-statusReason",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/status-reason",
"code": "reviewed",
"display": "Reviewed"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/problem-list-id",
"value": "PL-2026-001234"
}
],
"status": "current",
"mode": "working",
"code": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/list-example-use-codes",
"code": "problems",
"display": "Problem List"
}
]
},
"subject": [
{
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
}
],
"type": "Encounter",
"system": "https://fhir.synapxe.sg/NamingSystem/event-id",
"value": "EVT-2026-001234"
}
},
"source": {
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
},
"note": [
{
"text": "Patient problem list reviewed during admission. Two active conditions identified: Diabetes Mellitus (primary) and Essential Hypertension (secondary). Both conditions are under management with current medications."
}
],
"entry": [
{
"item": {
"reference": "#problem-001"
}
},
{
"item": {
"reference": "#problem-002"
}
}
]
}

Problem

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
healthDomainC0..1Extension(CodeableConcept)
serviceSpecialityC0..1Extension(CodeableConcept)
conditionTypeC0..1Extension(CodeableConcept)
modifierExtensionΣ ?! C0..*Extension
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
clinicalStatusΣ ?! C1..1CodeableConceptBinding
verificationStatusΣ ?!0..1CodeableConceptBinding
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uri
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uri
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
codeΣ1..1CodeableConcept
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uri
versionΣ0..0string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
subjectΣ C1..1Reference(Patient)
encounterΣ C0..0Reference(Encounter)
onsetAgeAge
onsetDateTimedateTime
abatementAgeAge
abatementDateTimedateTime
recordedDateΣ1..1dateTime
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
functionΣ1..1CodeableConceptBinding
actorΣ C1..1Reference(Organization | Practitioner)
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uri
versionΣ0..0string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
assessmentC0..0Reference(ClinicalImpression | DiagnosticReport | Observation)
type0..0CodeableConcept
evidenceΣ0..0CodeableReference(Resource)
id0..0string
extensionC0..*Extension
timeΣ0..0dateTime
textΣ1..1markdown

Successful Response

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
contextC0..1Extension(CodeableConcept)
statusReasonC0..1Extension(CodeableConcept)
modifierExtensionΣ ?! C0..*Extension
identifierC0..*Identifier
statusΣ ?!1..1codeBinding
modeΣ ?!1..1codeBindingFixed Value
titleΣ0..0string
codeΣ1..1CodeableConcept
subjectΣ C0..*Reference(Patient)
encounterC0..1Reference(Encounter)
dateΣ0..0dateTime
sourceΣ C0..1Reference(Organization)
orderedBy0..0CodeableConceptBinding
note0..1Annotation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
flag0..0CodeableConcept
deleted?!0..0boolean
date0..0dateTime
itemC1..1Reference(Problem)
emptyReasonC0..0CodeableConceptBinding
{
"resourceType": "List",
"id": "pl-2026-001234",
"meta": {
"versionId": "1",
"lastUpdated": "2026-02-10T10:30:00.1+08:00",
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-list-problem"
]
},
{
"resourceType": "Condition",
"id": "problem-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-problem"
]
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-healthDomain",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-serviceSpeciality",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/department-specialty",
"code": "PGN",
"display": "Paediatric Genetics"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-conditionType",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/condition-type",
"code": "primary",
"display": "Primary"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/sequence-no",
"value": "SEQ-PROB-001"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
],
"coding": [
{
"system": "http://snomed.info/sct",
"code": "24484000",
"display": "Severe"
}
]
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "15776009",
"display": "Pancreatic structure"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"onsetDateTime": "2024-06-15T00:00:00+08:00",
"recordedDate": "2024-06-15T10:30:00+08:00",
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "author",
"display": "Author"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
}
}
],
"stage": [
{
"summary": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "786005",
"display": "Clinical stage I"
}
]
}
}
],
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
},
"time": "2024-06-15T10:30:00+08:00",
"text": "Patient diagnosed with Type 2 Diabetes Mellitus. Started on Metformin 500mg BD. HbA1c at diagnosis: 8.2%. Target HbA1c < 7%."
}
]
},
{
"resourceType": "Condition",
"id": "problem-002",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-problem"
]
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-healthDomain",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-serviceSpeciality",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/department-specialty",
"code": "PGN",
"display": "Paediatric Genetics"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-conditionType",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/condition-type",
"code": "secondary",
"display": "Secondary"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/sequence-no",
"value": "SEQ-PROB-002"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/condition-ver-status",
"code": "confirmed",
"display": "Confirmed"
}
]
},
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/healthdomain-types",
"code": "medical",
"display": "Medical"
}
]
}
],
"coding": [
{
"system": "http://snomed.info/sct",
"code": "6736007",
"display": "Moderate"
}
]
},
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "38341003",
"display": "Hypertensive disorder"
}
]
},
{
"coding": [
{
"system": "http://snomed.info/sct",
"code": "80891009",
"display": "Heart structure"
}
]
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"value": 55,
"unit": "years",
"system": "http://unitsofmeasure.org",
"code": "a"
},
"abatementDateTime": "2026-01-20T00:00:00+08:00",
"recordedDate": "2023-03-10T14:00:00+08:00",
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "author",
"display": "Author"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M67890"
},
"display": "Dr. Michael Tan"
}
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "informant",
"display": "Informant"
}
]
},
"actor": {
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
}
],
"note": [
{
"authorString": "Dr. Michael Tan",
"time": "2023-03-10T14:00:00+08:00",
"text": "Essential hypertension diagnosed during routine health screening. Currently managed with Amlodipine 5mg OD. Blood pressure well controlled at last visit (128/78 mmHg)."
}
]
}
],
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-context",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/clinical-setting",
"code": "admission",
"display": "Admission"
}
]
}
},
{
"url": "https://fhir.synapxe.sg/StructureDefinition/ext-statusReason",
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/status-reason",
"code": "reviewed",
"display": "Reviewed"
}
]
}
}
],
{
"system": "https://fhir.synapxe.sg/NamingSystem/problem-list-id",
"value": "PL-2026-001234"
}
],
"status": "current",
"mode": "working",
"code": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/list-example-use-codes",
"code": "problems",
"display": "Problem List"
}
]
},
"subject": [
{
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
}
],
"type": "Encounter",
"system": "https://fhir.synapxe.sg/NamingSystem/event-id",
"value": "EVT-2026-001234"
}
},
"source": {
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
},
"note": [
{
"text": "Patient problem list reviewed during admission. Two active conditions identified: Diabetes Mellitus (primary) and Essential Hypertension (secondary). Both conditions are under management with current medications."
}
],
"entry": [
{
"item": {
"reference": "#problem-001"
}
},
{
"item": {
"reference": "#problem-002"
}
}
]
}

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 group organization is not found
404 not-found E-10002 Group 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