API Name: put-screening-summary


This API creates the Screening Summary record which contains a collection of screening observation results for a patient. The observations capture measurements taken during health screening sessions across multiple screening stages.

Specification


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

Request Body

Remarks:

  • (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.

Bundle

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
id0..1string
extensionC0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uriFixed Value
valueΣ C0..1string
periodΣ C0..1Period
assignerΣ C0..1Reference(Organization)
typeΣ C1..1codeBindingFixed Value
timestampΣ C0..0instant
totalΣ C0..0unsignedInt
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
fullUrlΣ C1..1uri
resourceΣ C1..1Observation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
methodΣ C1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
signatureΣ0..0Signature
issuesΣ C0..0OperationOutcome

idΣ0..1id
id0..1string
extensionC0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..1canonical(StructureDefinition)
securityΣ C0..*CodingBinding
tagΣ C0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
extensionC0..*Extension
modifierExtensionΣ ?! C0..0Extension
basedOnΣ C0..0Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)
partOfΣ C0..0Reference(GenomicStudy | ImagingStudy | Immunization | MedicationAdministration | MedicationDispense | MedicationStatement | Procedure)
statusΣ ?!1..1codeBinding
category1..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
subjectΣ C1..1Reference(Patient)
focusΣ C0..0Reference(Resource)
encounterΣ C0..0Reference(Encounter)
effectiveDateTimedateTime
issuedΣ0..0instant
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Σ C1..1string
id0..0string
extensionC0..0Extension
valueΣ1..1decimal
comparatorΣ ?!0..0codeBinding
unitΣ1..1string
systemΣ C1..1uri
codeΣ C1..1code
dataAbsentReasonC0..0CodeableConceptBinding
bodyStructureC0..0Reference(BodyStructure)
specimenC0..0Reference(Specimen)
deviceC0..0Reference(Device)
hasMemberΣ C0..0Reference(MolecularSequence | Observation | QuestionnaireResponse)
derivedFromΣ C0..0Reference(DocumentReference | GenomicStudy | ImagingSelection | ImagingStudy | MolecularSequence | Observation | QuestionnaireResponse)
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
valueAttachmentAttachment
valueBooleanboolean
valueCodeableConceptCodeableConcept
valueDateTimedateTime
valueIntegerinteger
valuePeriodPeriod
valueQuantityQuantity
valueRangeRange
valueRatioRatio
valueReferenceReference(MolecularSequence)
valueSampledDataSampledData
valueStringstring
valueTimetime
dataAbsentReason0..0CodeableConceptBinding
interpretation0..0CodeableConceptBinding
referenceRange0..0see (referenceRange)
{
"resourceType": "Bundle",
"system": "https://fhir.synapxe.sg/NamingSystem/bundle-id",
"value": "BDL-SS-2026-001234"
},
"type": "transaction",
"entry": [
{
"fullUrl": "urn:uuid:screening-obs-001",
"resourceType": "Observation",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-observation"
]
},
"status": "final",
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/screen-type",
"code": "firstScreen",
"display": "First Screen"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8302-2",
"display": "Body height"
}
]
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"effectiveDateTime": "2026-02-10T09:00:00+08:00",
{
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
],
"value": 170.5,
"unit": "cm",
"system": "http://unitsofmeasure.org",
"code": "cm"
}
},
"request": {
"method": "PUT",
"url": "Observation?identifier=screening-obs-001"
}
},
{
"fullUrl": "urn:uuid:screening-obs-002",
"resourceType": "Observation",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-observation"
]
},
"status": "final",
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/screen-type",
"code": "firstScreen",
"display": "First Screen"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "29463-7",
"display": "Body weight"
}
]
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"effectiveDateTime": "2026-02-10T09:00:00+08:00",
{
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
],
"value": 72.3,
"unit": "kg",
"system": "http://unitsofmeasure.org",
"code": "kg"
}
},
"request": {
"method": "PUT",
"url": "Observation?identifier=screening-obs-002"
}
},
{
"fullUrl": "urn:uuid:screening-obs-003",
"resourceType": "Observation",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-observation"
]
},
"status": "final",
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/screen-type",
"code": "firstScreen",
"display": "First Screen"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "39156-5",
"display": "Body mass index (BMI)"
}
]
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"effectiveDateTime": "2026-02-10T09:00:00+08:00",
{
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
],
"value": 24.9,
"unit": "kg/m2",
"system": "http://unitsofmeasure.org",
"code": "kg/m2"
}
},
"request": {
"method": "PUT",
"url": "Observation?identifier=screening-obs-003"
}
},
{
"fullUrl": "urn:uuid:screening-obs-004",
"resourceType": "Observation",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-observation"
]
},
"status": "final",
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/screen-type",
"code": "secondScreen",
"display": "Second Screen"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "85354-9",
"display": "Blood pressure panel"
}
]
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"effectiveDateTime": "2026-02-10T09:15:00+08:00",
{
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
],
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8480-6",
"display": "Systolic blood pressure"
}
]
},
"value": 128,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
},
{
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "8462-4",
"display": "Diastolic blood pressure"
}
]
},
"value": 78,
"unit": "mmHg",
"system": "http://unitsofmeasure.org",
"code": "mm[Hg]"
}
}
]
},
"request": {
"method": "PUT",
"url": "Observation?identifier=screening-obs-004"
}
},
{
"fullUrl": "urn:uuid:screening-obs-005",
"resourceType": "Observation",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-observation"
]
},
"status": "final",
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/screen-type",
"code": "thirdScreen",
"display": "Third Screen"
}
]
}
],
"code": {
"coding": [
{
"system": "http://loinc.org",
"code": "2339-0",
"display": "Glucose [Mass/volume] in Blood"
}
]
},
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S1234567A"
}
},
"effectiveDateTime": "2026-02-10T09:30:00+08:00",
{
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
}
],
"value": 5.4,
"unit": "mmol/L",
"system": "http://unitsofmeasure.org",
"code": "mmol/L"
}
},
"request": {
"method": "PUT",
"url": "Observation?identifier=screening-obs-005"
}
}
]
}

Successful Response

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
id0..1string
extensionC0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uriFixed Value
valueΣ C0..1string
periodΣ C0..1Period
assignerΣ C0..1Reference(Organization)
typeΣ C1..1codeBindingFixed Value
timestampΣ C0..0instant
totalΣ C0..0unsignedInt
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
fullUrlΣ C1..1uri
resourceΣ C1..1Observation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
methodΣ C1..1codeBinding
urlΣ1..1uri
ifNoneMatchΣ0..1string
ifModifiedSinceΣ0..1instant
ifMatchΣ0..1string
ifNoneExistΣ0..1string
signatureΣ0..0Signature
issuesΣ C0..0OperationOutcome
{
"resourceType": "Bundle",
"type": "transaction-response",
"entry": [
{
"status": "201 Created",
"location": "Observation/screening-obs-001/_history/1",
"etag": "1",
"lastModified": "2026-02-10T09:30:00.1+08:00"
}
},
{
"status": "201 Created",
"location": "Observation/screening-obs-002/_history/1",
"etag": "1",
"lastModified": "2026-02-10T09:30:00.101+08:00"
}
},
{
"status": "201 Created",
"location": "Observation/screening-obs-003/_history/1",
"etag": "1",
"lastModified": "2026-02-10T09:30:00.102+08:00"
}
},
{
"status": "201 Created",
"location": "Observation/screening-obs-004/_history/1",
"etag": "1",
"lastModified": "2026-02-10T09:30:00.103+08:00"
}
},
{
"status": "201 Created",
"location": "Observation/screening-obs-005/_history/1",
"etag": "1",
"lastModified": "2026-02-10T09:30:00.104+08:00"
}
}
]
}

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