API Name: put-allergyintolerance


This API creates or updates an AllergyIntolerance record documenting a clinical assessment of a patient's allergy or intolerance to a substance, including medications, foods, environmental factors, and biological agents. The record captures the substance, clinical and verification status, severity, reactions, and the practitioner who recorded the allergy.

Specification


Endpoint [baseurl]/AllergyIntolerance/$put-allergyintolerance
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 AllergyIntolerance resource type.
  • AllergyIntolerance.identifier.system must be fixed to https://fhir.synapxe.sg/NamingSystem/record-id.
  • AllergyIntolerance.patient requires type (fixed to "Patient") and identifier with system https://fhir.synapxe.sg/NamingSystem/nric.
  • AllergyIntolerance.participant (1..*) is required; participant.function must be present with a required binding, and participant.actor requires type (fixed to "Practitioner") and identifier with system https://fhir.synapxe.sg/NamingSystem/mcr.
  • AllergyIntolerance.onset[x] supports onsetDateTime, onsetAge, onsetPeriod, or onsetString.
  • AllergyIntolerance.reaction.manifestation.concept.text is required if reaction is present.
  • AllergyIntolerance.reaction.severity is required if reaction is present.
  • (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.

AllergyIntolerance

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..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
clinicalStatusΣ ?!1..1CodeableConceptBinding
verificationStatusΣ ?!1..1CodeableConceptBinding
typeΣ0..1CodeableConceptBinding
categoryΣ0..*codeBinding
criticalityΣ0..1codeBinding
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..1string
extensionC0..*Extension
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
encounterC0..0Reference(Encounter)
onsetAgeAge
onsetDateTimedateTime
onsetPeriodPeriod
onsetStringstring
recordedDate1..1dateTime
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
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
lastOccurrence0..1dateTime
note0..0Annotation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
substance0..0CodeableConcept
id0..0string
extensionC0..0Extension
id0..1string
extensionC0..0Extension
codingΣ C0..*Coding
textΣ1..1string
referenceΣ C0..0Reference
description0..1string
onset0..1dateTime
severity1..1codeBinding
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
note0..*Annotation
{
"resourceType": "AllergyIntolerance",
"meta": {
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-allergyintolerance"
]
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "AI-2026-00891"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
"code": "confirmed",
"display": "Confirmed"
}
]
},
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/allergy-intolerance-type",
"code": "allergy",
"display": "Allergy"
}
]
},
"medication"
],
"criticality": "high",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "372687004",
"display": "Amoxicillin"
}
],
"text": "Amoxicillin (Penicillin-type antibiotic)"
},
"patient": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S7654321B"
}
},
"onsetDateTime": "2015-03-15T00:00:00+08:00",
"recordedDate": "2026-02-20T09: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": "M56789"
},
"display": "Dr. Chan Siew Lin"
}
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "verifier",
"display": "Verifier"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M67890"
},
"display": "Dr. Wong Ah Kow"
}
}
],
{
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39579001",
"display": "Anaphylaxis"
}
],
"text": "Anaphylactic reaction with urticaria, angioedema, and bronchospasm"
}
}
],
"severity": "severe",
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route"
}
]
},
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M56789"
},
"display": "Dr. Chan Siew Lin"
},
"time": "2026-02-20T09:00:00+08:00",
"text": "Patient developed severe anaphylaxis within 15 minutes of first dose of amoxicillin 500mg oral. Required emergency treatment with adrenaline 0.5mg IM, chlorphenamine 10mg IV, and hydrocortisone 200mg IV. Full recovery achieved."
}
]
}
]
}

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..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ C1..1string
periodΣ C0..0Period
assignerΣ C0..0Reference(Organization)
clinicalStatusΣ ?!1..1CodeableConceptBinding
verificationStatusΣ ?!1..1CodeableConceptBinding
typeΣ0..1CodeableConceptBinding
categoryΣ0..*codeBinding
criticalityΣ0..1codeBinding
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..1string
extensionC0..*Extension
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
encounterC0..0Reference(Encounter)
onsetAgeAge
onsetDateTimedateTime
onsetPeriodPeriod
onsetStringstring
recordedDate1..1dateTime
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
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
lastOccurrence0..1dateTime
note0..0Annotation
id0..0string
extensionC0..0Extension
modifierExtensionΣ ?! C0..0Extension
substance0..0CodeableConcept
id0..0string
extensionC0..0Extension
id0..1string
extensionC0..0Extension
codingΣ C0..*Coding
textΣ1..1string
referenceΣ C0..0Reference
description0..1string
onset0..1dateTime
severity1..1codeBinding
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
note0..*Annotation
{
"resourceType": "AllergyIntolerance",
"id": "ai-2026-00891",
"meta": {
"versionId": "1",
"lastUpdated": "2026-02-20T09:00:00.1+08:00",
"profile": [
"https://fhir.synapxe.sg/StructureDefinition/profile-allergyintolerance"
]
},
{
"system": "https://fhir.synapxe.sg/NamingSystem/record-id",
"value": "AI-2026-00891"
}
],
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
"code": "active",
"display": "Active"
}
]
},
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
"code": "confirmed",
"display": "Confirmed"
}
]
},
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/allergy-intolerance-type",
"code": "allergy",
"display": "Allergy"
}
]
},
"medication"
],
"criticality": "high",
"code": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "372687004",
"display": "Amoxicillin"
}
],
"text": "Amoxicillin (Penicillin-type antibiotic)"
},
"patient": {
"type": "Patient",
"system": "https://fhir.synapxe.sg/NamingSystem/nric",
"value": "S7654321B"
}
},
"onsetDateTime": "2015-03-15T00:00:00+08:00",
"recordedDate": "2026-02-20T09: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": "M56789"
},
"display": "Dr. Chan Siew Lin"
}
},
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/provenance-participant-type",
"code": "verifier",
"display": "Verifier"
}
]
},
"actor": {
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M67890"
},
"display": "Dr. Wong Ah Kow"
}
}
],
{
{
"concept": {
"coding": [
{
"system": "http://snomed.info/sct",
"code": "39579001",
"display": "Anaphylaxis"
}
],
"text": "Anaphylactic reaction with urticaria, angioedema, and bronchospasm"
}
}
],
"severity": "severe",
"coding": [
{
"system": "http://snomed.info/sct",
"code": "26643006",
"display": "Oral route"
}
]
},
"note": [
{
"type": "Practitioner",
"system": "https://fhir.synapxe.sg/NamingSystem/mcr",
"value": "M56789"
},
"display": "Dr. Chan Siew Lin"
},
"time": "2026-02-20T09:00:00+08:00",
"text": "Patient developed severe anaphylaxis within 15 minutes of first dose of amoxicillin 500mg oral. Required emergency treatment with adrenaline 0.5mg IM, chlorphenamine 10mg IV, and hydrocortisone 200mg IV. Full recovery achieved."
}
]
}
]
}

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 allergy intolerance identifier
400 invalid E-10006 Invalid clinical or verification status