API Name: put-event


This API creates an Encounter record representing an interaction between a patient and healthcare provider(s) for the purpose of providing healthcare service(s) or assessing the health status of a patient.

Specification


Endpoint [baseurl]/Encounter/$put-event
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 Encounter resource type.
  • The request body contains a single Encounter resource.

Encounter

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
id0..0string
extensionC0..0Extension
useΣ ?!0..1codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uri
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
statusΣ ?!1..1codeBinding
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
priority0..0CodeableConcept
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
referenceΣ C0..0Reference
subjectΣ C1..1Reference(Patient)
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
episodeOfCareΣ C0..0Reference(EpisodeOfCare)
basedOnC0..0Reference(CarePlan | DeviceRequest | MedicationRequest | ServiceRequest)
careTeamC0..0Reference(CareTeam)
partOfC0..0Reference(Encounter)
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..0string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
periodC0..0Period
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
appointmentΣ C0..0Reference(Appointment)
virtualService0..0VirtualServiceDetail
id0..1string
extensionC0..*Extension
startΣ C1..1dateTime
endΣ C0..1dateTime
plannedStartDate0..0dateTime
plannedEndDate0..0dateTime
lengthC0..0Duration
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
id0..0string
extensionC0..0Extension
conceptΣ0..1CodeableConcept
referenceΣ C0..1Reference
accountC0..0Reference(Account)
dietPreference0..0CodeableConcept
specialArrangement0..0CodeableConceptBinding
specialCourtesy0..0CodeableConceptBinding
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
preAdmissionIdentifierC0..0Identifier
originC0..0Reference(Location | Organization)
admitSource0..0CodeableConceptBinding
reAdmission0..0CodeableConcept
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..1string
extensionC0..0Extension
id0..1string
extensionC0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..0string
codeΣ C0..1code
displayΣ C0..1string
userSelectedΣ0..1boolean
textΣ1..1string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
locationC1..1Reference(Location)
status0..0codeBinding
form0..0CodeableConcept
periodC0..0Period
{
"resourceType": "Encounter",
"id": "encounter-put-event-001",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-encounter"
]
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "REC-ENC-2026-001234"
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/case-id",
"value": "CASE-2026-001234"
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/movement-id",
"value": "MOV-001"
}
],
"status": "completed",
"class": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/patient-type",
"code": "I",
"display": "Inpatient"
}
]
}
],
{
"concept": {
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/service-speciality",
"code": "102",
"display": "Cardiology"
}
]
}
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric-fin",
"value": "S1234567A"
},
"display": "John Tan"
},
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/event-type",
"code": "1",
"display": "Admission encounter"
}
]
},
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
},
{
"type": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/encounter-participant-type",
"code": "ATND",
"display": "Attender"
}
]
}
],
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
}
}
],
"start": "2026-02-10T08:00:00+08:00",
"end": "2026-02-10T12:00:00+08:00"
},
"reason": [
{
"use": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/encounter-reason-type",
"code": "chief-complaint",
"display": "Chief Complaint"
}
]
}
],
"value": [
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "29857009",
"display": "Chest pain"
}
]
}
}
]
}
],
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/admit-source",
"code": "emergency",
"display": "Emergency Department"
}
]
},
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/discharge-disposition",
"code": "home",
"display": "Home"
}
]
}
},
{
"type": "Location",
"system": "https://fhir.synapxe.sg/NamingSystem/location-id",
"value": "WARD-A-101"
},
"display": "Ward A - Room 101"
},
"period": {
"start": "2026-02-10T08:00:00+08:00",
"end": "2026-02-10T12:00:00+08:00"
}
}
]
}

Successful Response

idΣ0..1id
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
textC0..1Narrative
containedC0..*Resource
extensionC0..*Extension
modifierExtensionΣ ?! C0..*Extension
id0..0string
extensionC0..0Extension
useΣ ?!0..1codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uri
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
id0..0string
extensionC0..0Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
statusΣ ?!1..1codeBinding
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
priority0..0CodeableConcept
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
referenceΣ C0..0Reference
subjectΣ C1..1Reference(Patient)
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
episodeOfCareΣ C0..0Reference(EpisodeOfCare)
basedOnC0..0Reference(CarePlan | DeviceRequest | MedicationRequest | ServiceRequest)
careTeamC0..0Reference(CareTeam)
partOfC0..0Reference(Encounter)
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..0string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
id0..0string
extensionC0..0Extension
id0..0string
extensionC0..0Extension
systemΣ1..1uriFixed Value
versionΣ0..1string
codeΣ C1..1code
displayΣ C1..1string
userSelectedΣ0..0boolean
textΣ0..0string
periodC0..0Period
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
appointmentΣ C0..0Reference(Appointment)
virtualService0..0VirtualServiceDetail
id0..1string
extensionC0..*Extension
startΣ C1..1dateTime
endΣ C0..1dateTime
plannedStartDate0..0dateTime
plannedEndDate0..0dateTime
lengthC0..0Duration
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
id0..0string
extensionC0..0Extension
conceptΣ0..1CodeableConcept
referenceΣ C0..1Reference
accountC0..0Reference(Account)
dietPreference0..0CodeableConcept
specialArrangement0..0CodeableConceptBinding
specialCourtesy0..0CodeableConceptBinding
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
preAdmissionIdentifierC0..0Identifier
originC0..0Reference(Location | Organization)
admitSource0..0CodeableConceptBinding
reAdmission0..0CodeableConcept
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..1string
extensionC0..0Extension
id0..1string
extensionC0..*Extension
systemΣ0..1uriFixed Value
versionΣ0..0string
codeΣ C0..1code
displayΣ C0..1string
userSelectedΣ0..1boolean
textΣ1..1string
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
locationC1..1Reference(Location)
status0..0codeBinding
form0..0CodeableConcept
periodC0..0Period
{
"resourceType": "Encounter",
"id": "encounter-put-event-001",
"meta": {
"versionId": "2",
"lastUpdated": "2026-02-10T16:22:35.91+08:00"
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "REC-ENC-2026-001234"
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/case-id",
"value": "CASE-2026-001234"
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/movement-id",
"value": "MOV-001"
}
],
"status": "completed",
"class": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/patient-type",
"code": "I",
"display": "Inpatient"
}
]
}
],
{
"concept": {
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/service-speciality",
"code": "102",
"display": "Cardiology"
}
]
}
}
],
"subject": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric-fin",
"value": "S1234567A"
},
"display": "John Tan"
},
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/event-type",
"code": "1",
"display": "Admission encounter"
}
]
},
"type": "Organization",
"system": "https://fhir.synapxe.sg/NamingSystem/hci-code",
"value": "11234"
},
"display": "National University Hospital"
},
{
"type": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/encounter-participant-type",
"code": "ATND",
"display": "Attender"
}
]
}
],
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M12345"
},
"display": "Dr. Sarah Lim"
}
}
],
"start": "2026-02-10T08:00:00+08:00",
"end": "2026-02-10T12:00:00+08:00"
},
"reason": [
{
"use": [
{
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/encounter-reason-type",
"code": "chief-complaint",
"display": "Chief Complaint"
}
]
}
],
"value": [
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "29857009",
"display": "Chest pain"
}
]
}
}
]
}
],
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/admit-source",
"code": "emergency",
"display": "Emergency Department"
}
]
},
"coding": [
{
"system": "https://fhir.synapxe.sg/CodeSystem/discharge-disposition",
"code": "home",
"display": "Home"
}
]
}
},
{
"type": "Location",
"system": "https://fhir.synapxe.sg/NamingSystem/location-id",
"value": "WARD-A-101"
},
"display": "Ward A - Room 101"
},
"period": {
"start": "2026-02-10T08:00:00+08:00",
"end": "2026-02-10T12:00:00+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 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 identifier system or value
400 invalid E-10006 Invalid encounter status