Examples
Use Case 1: Documentation of Information Related to Allergy, Hypersensitivity, and Intolerance
Scenario 1.1 Documentation of an adverse reaction to a drug substance
Scenario : A physician sees a patient in clinic for routine outpatient care. Recently the patient was prescribed penicillin V 500 mg orally two times daily x 10 days for streptococcal pharyngitis. He tells the physician that he has developed hives the previous week and on examination, the physician confirms the presence of generalized hives. He records this in the patient record as an Observation.
FHIR Observation resource query from patient record (see FHIR representation here)
code*
LOINC: 80343-7 | Skin assessment [Interpretation] |
271303006 | Examination of skin (procedure) |
status
final
-
category
Exam
-
valueCodableConcept
247472004 | Wheal (finding) |
bodySite
39937001 | Skin structure (body structure) |
*LOINC codes are the recommended coding system for the FHIR observation.code element but the observation.code being a CodableConcept, one may choose also to use SNOMED CT concepts to represent the value in this field.
A review of systems fails to reveal any other causes and the physician believes that the patient may be having an urticarial reaction to penicillin. He has lingering uncertainty about this and tells the patient to stop the penicillin and employ diphenhydramine for relief. He schedules him back in a week for follow-up and when recording his note for the visit, he adds to his assessment in the problem list: “Moderate urticarial reaction, possible penicillin allergy”.
FHIR Condition resource query from patient record (see FHIR representation here)
code
Urticarial reaction
126485001 |Urticaria (disorder)|
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
problem-list-item
-
severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|
bodySite
39937001 |Skin structure (body structure)|
A week later, the patient returns for follow-up with the itching and rash entirely resolved. He reports that the reaction subsided within days after stopping the penicillin. The physician adds “Penicillin allergy probable: moderate reaction of hives; criticality unable-to-assess” to the allergy list.
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
764146007 |Penicillin (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
unconfirmed
415684004 |Suspected (qualifier value)|
category
medication
-
criticality
unable-to-assess
-
reaction.manifestation
247472004 |Wheal (finding)|
reaction.severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
91936005 |Allergy to penicillin (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
unconfirmed
415684004 |Suspected (qualifier value)|
category
medication
-
criticality
unable-to-assess
-
reaction.manifestation
247472004 |Wheal (finding)|
reaction.severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
*The use of a SNOMED CT concept to represent these values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).

Scenario 1.2 Documentation in drug allergy list by provider and use as allergy alert
Scenario : Several years later, the same patient who has since received an aortic valve replacement is seeing another physician within the organization for consultation on antibiotic prophylaxis for an upcoming dental procedure. The second physician decides that a penicillin class antibiotic is appropriate for the patient.
When the physician creates an order for amoxicillin 2 g orally as a single dose and commits to the electronic prescription, an alert appears which requires a response by the physician warning him of an allergy history to penicillin. The substance-based alert is generated by the EHR drug-disease interactions software, which uses the Allergy list as a reference. As the patient has not received penicillin class antibiotics for several years, the physician decides to refer the patient to an allergy specialist for clarification of current status of penicillin allergy.
The specialist performs skin testing for penicillin allergy, the results of which are positive. The patient is confirmed as penicillin allergic and the results of the testing are documented in the patient’s medical record.
The patient is subsequently prescribed azithromycin for his dental procedure.
FHIR Observation resource for the positive skin test (see FHIR representation here)
code*
252515007 |Type 1 hypersensitivity skin test (procedure)|
status
final
-
category
procedure
-
valueCodableConcept
10828004 |Positive (qualifier value)|
bodySite
39937001 |Skin structure (body structure)|
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
764146007 |Penicillin (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
refuted
410605003 |Confirmed present (qualifier value)|
category
medication
-
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
91936005 |Allergy to penicillin (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
refuted
410605003 |Confirmed present (qualifier value)|
category
medication
-
*The use of a SNOMED CT concept to represent theses values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).
Scenario 1.3 Documentation of a food intolerance
Scenario: A 34-year-old female is seen by her primary care provider for complaints of abdominal pain, bloating and change in bowel habits within hours or a few days after ingesting whole wheat bread. In addition, she complains of feeling tired but denies itching rash or wheezing. Those complaints are entered as observations in the EHR.
FHIR Condition resource query from patient record (see FHIR representation here)
code
-
116289008 |Abdominal bloating (finding)|
21522001 |Abdominal pain (finding)|
84229001 |Fatigue (finding)|
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
problem-list-item
-
Due to a family history of celiac disease, tissue transglutaminase IgG and IgA are ordered which are negative. The patient is also referred to a gastroenterologist, who performs an endoscopic biopsy, which is negative for celiac disease. (Both of these examination results can be recorded in the EHR as a FHIR observation using LOINC codes).
The patient is advised to avoid wheat and gluten containing products. An encounter diagnosis of moderate wheat intolerance is documented in the patient’s health record and wheat is entered in the patient’s “allergy” list.
FHIR Condition resource query from patient problem list record (see FHIR representation here)
code
700095006 |Intolerance to wheat (finding)|
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
unconfirmed
415684004 |Suspected (qualifier value)|
category
Encounter-diagnosis
-
severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|
bodySite
5668004 |Lower gastrointestinal tract structure (body structure)|
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
412071004 |Wheat (substance)|
type
intolerance
782197009 |Intolerance to substance (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
food
-
criticality
low
-
reaction.manifestation
116289008 |Abdominal bloating (finding)|
21522001 |Abdominal pain (finding)|
reaction.severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
700095006 |Intolerance to wheat (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
food
-
criticality
low
-
reaction.manifestation
116289008 |Abdominal bloating (finding)|
21522001 |Abdominal pain (finding)|
reaction.severity
moderate
6736007 |Moderate (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
*The use of a SNOMED CT concept to represent theses values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).

Scenario 1.4 Documentation of animal allergy or hypersensitivity
The causative agent for the realization of an allergic process directed against a living organism (plant or animal) is not the organism itself or a part of the organism such as epithelium but in most cases is a protein derived from the organism. An allergy to an animal should therefore be modeled with a causative agent that is a descendant of 272169002 |Animal protein (substance)| as in the concept below.

Likewise animal related material such as dander, feathers, urine, serum, etc. represent sources where the allergenic proteins are found and should not be used as the causative agents for allergy finding and disorder concepts. Allergen sources should only be used as the active ingredients of products containing these materials such as 411572004 |Cat dander diagnostic allergen extract (product)|.

Scenario : A physician sees a patient for the first time in clinic for routine outpatient care. The patient tells the physician that he has begun to experience asthma symptoms. The physician runs some blood tests and a series of skin tests, which demonstrate an intense reaction to the house dust mite, Dermatophagoides farinae protein with high IgE antibody levels.
FHIR Observation resource for the positive IgE lab test (see FHIR representation here)
code*
LOINC: 6095-4 American house dust mite IgE Ab [Units/volume] in Serum
388810005 |Dermatophagoides farinae specific immunoglobulin E antibody measurement (procedure)|
status
final
-
category
laboratory
-
valueQuantity
59.1 k[IU]/L
-
interpretation
high
-
*LOINC codes are the recommended coding system for the FHIR observation.code element but the observation.code being a CodableConcept, one may choose also to use SNOMED CT concepts to represent the value in this field.

The patient confirms that his wheezing occurs primarily at home, especially while lying in bed at night. The physician opens the allergy record and documents the allergic propensity to Dermatophagoides farinae protein, criticality and severity of low in the EHR allergy list.
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
711092006 |Dermatophagoides farinae protein (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
environment
-
criticality
low
-
reaction.manifestation
N/A
195967001 |Asthma (disorder)|
reaction.severity
mild
255604002 |Mild (qualifier value)|*
reaction.exposureRoute
447694001 |Respiratory tract route (qualifier value)|
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
703902000 |Allergy to Dermatophagoides farinae protein (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
environment
-
criticality
low
-
reaction.manifestation
195967001 |Asthma (disorder)|
reaction.severity
mild
255604002 |Mild (qualifier value)|*
reaction.exposureRoute
447694001 |Respiratory tract route (qualifier value)|
*The use of a SNOMED CT concept to represent theses values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).
Scenario 1.5 Documentation of adverse reaction to a non-medicinal substance cross reacting with a pharmaceutical
Scenario : A patient’s mother reports to their child’s physician that the child reacts violently to eating peanuts with symptoms that include generalized hives, wheezing and hypotension requiring use of epinephrine for resuscitation. The physician obtains a blood test which documents high levels of IgE antibody against the Arachis h2 peanut protein which is found in unrefined peanut oil (Arachis oil) - the sensitizing agent for clinical peanut allergy. Ara h2 is associated with a risk of severe reactions to peanut. The physician records a peanut allergy in the EHR with anaphylaxis, hives and wheezing as reaction symptoms, records a criticality of high and reaction severity of ‘severe’.
FHIR Observation resource for the positive IgE lab test (see FHIR representation here) Attribute| FHIR code| SNOMED CT concept
code*
LOINC: 58778-2|Peanut recombinant (rAra h) 2 IgE Ab [Units/volume] in Serum
445354008 |Measurement of Ara h 2 immunoglobulin E (procedure)|
status
final
-
category
laboratory
-
valueQuantity
>100 k[IU]/L
-
interpretation
high
-
*LOINC codes are the recommended coding system for the FHIR observation.code element but the observation.code being a CodableConcept, one may choose also to use SNOMED CT concepts to represent the value in this field.
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
762952008 |Peanut (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
food
-
criticality
high
-
reaction.manifestation
N/A
39579001 |Anaphylaxis (disorder)|
reaction.severity
severe
24484000 |Severe (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
91935009 |Allergy to peanut (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
food
-
criticality
high
-
reaction.manifestation
39579001 |Anaphylaxis (disorder)|
reaction.severity
severe
24484000 |Severe (severity modifier) (qualifier value)|*
reaction.exposureRoute
26643006 |Oral route (qualifier value)|
*The use of a SNOMED CT concept to represent theses values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).
Years later, the youngster is seen by a dermatologist for treatment of acne. As part of the plan of care, the physician enters an electronic prescription for Isotretinoin capsules. When the physician commits the order, the EHR software runs allergy cross checking and issues a high priority alert that the capsules contain peanut oil that is not highly refined and therefore may potentially include peanut protein and are contraindicated for the patient. The physician cancels the order and chooses an alternative preparation.
Scenario 1.6 Documentation of adverse reaction to other non-medicinal substances
Scenario: A licensed nurse presents to her personal physician for recurring problems of a generalized rash and itching. She works in an intensive care unit and is constantly handing chemicals, disinfectants, assisting in surgical procedures and performing catheter cares for her patients. As a part of the health history, she noticed that she had an eruption on her hands after handling latex catheters. Additionally, she reports a serious allergic reaction to papaya in the past and has been careful in the fruits she eats as a consequence. The clinician suspects a latex allergy cross-reacting with foodstuffs and orders IgE testing for Hevea latex antibody. The serology testing is strongly positive and the clinician advises the nurse of his findings with warnings about other foods, which may cross react. While documenting the clinical encounter, he records a latex allergy in the allergy list.
The EHR software supports selection of foods, chemicals and animal biological products as substances, which may be identified as source substances for an entry onto the allergy list or for recording of an adverse reaction.
FHIR Condition resource query from patient record (see FHIR representation here)
code
-
271807003 |Eruption of skin (disorder)|
418363000 |Itching of skin (finding)|
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
problem-list-item
-
FHIR Observation resource for the latex IgE level (see FHIR representation here)
code
LOINC: 6158-0 |Latex IgE Ab [Units/volume] in Serum|
392475005 |Hevea brasiliensis specific immunoglobulin E antibody measurement (procedure)|
status
final
-
category
laboratory
-
valueQuantity
>100 k[IU]/L
-
interpretation
high
-
*LOINC codes are the recommended coding system for the FHIR observation.code element but the observation.code being a CodableConcept, one may choose also to use SNOMED CT concepts to represent the value in this field.
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
1003752001 |Hevea brasiliensis latex protein (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
environment
-
reaction.manifestation
271807003 |Eruption of skin (disorder)|
418363000 |Itching of skin (finding)|
reaction.severity
mild
255604002 |Mild (qualifier value)|*
reaction.exposureRoute
6064005 |Topical route (qualifier)|
Or
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
1003755004 |Allergy to Hevea brasiliensis latex protein (finding)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
environment
-
reaction.manifestation
271807003 |Eruption of skin (disorder)|
418363000 |Itching of skin (finding)|
reaction.severity
mild
255604002 |Mild (qualifier value)|*
reaction.exposureRoute
6064005 |Topical route (qualifier)|
*The use of a SNOMED CT concept to represent theses values requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).
Scenario 1.7 Recording of ‘No known allergies’
Scenario : A nurse is performing an intake examination on a patient that is new to the clinical practice. As part of the clinical interview, he inquires about medication and other allergies. The patient reports that she is not allergic to any medications, foods, chemicals or animals. The nurse opens the ‘allergy list’ in the EHR and documents ‘No known allergies’ which electronically validates that the nurse inquired of the patient and that the history was confirmed negative at the date and time recorded. This satisfies decision support criteria that allergies be documented before medication orders are written and is encoded in the EHR allergy list as confirmed absence of dispositions to adverse reactions.
FHIR resource query from patient record (see FHIR representation here); EHR using a finding focused AllergyIntolerance resource
code
716186003 |No known allergy (situation)|
type
-
-
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
confirmed
410605003 |Confirmed present (qualifier value)|
category
-
-

Alternatively, the EHR could represent no known allergies by using certainty degree of refuted (confirmed absent) to "negate" the recorded substance concept. This method has the advantage of allowing to record the absence of very specific individual allergies that may not exist in SNOMED CT as pre-coordinated Situation with explicit context concepts. Indeed, it might be interesting to record that the physician has asked specifically if the patient has latex allergy, contrast product allergy, iodine disinfectant allergy, etc. before performing a procedure.
FHIR resource query from patient record (see FHIR representation here); EHR using a substance focused AllergyIntolerance resource
code
105590001 |Substance (substance)|
type
allergy
609328004 |Allergic disposition (finding)|*
clinicalStatus
active
55561003 |Active (qualifier value)|
verificationStatus
refuted
410594000 |Definitely NOT present (qualifier value)|
category
-
-
*The use of a SNOMED CT concept to represent this value requires the use of a FHIR extension in HL7® FHIR® v4.3.0: R4B - STU (see 2.2.3.1).
Use case 2: Sharing adverse reaction data
Scenario: The patient from Scenario 1.1 is planning a vacation with his family consisting of a cross-country camping trip. In preparation for travels, he speaks to his physician in hospital A and obtains an electronic summary of his healthcare record on a flash drive for himself, his wife and children. His physician informs him that the summary software includes an electronic ‘reader’ as well as a standard format that can be imported into another EHR for patient care. Their vacation unfolds happily until, many miles from home the patient experiences an episode of right ear pain and is taken to a local emergency room in hospital B. He provides the flash drive with his electronic record summary to the emergency room physician whose hospital employs an EHR which can accept FHIR extracted electronic record summaries for integration into the on-site health record system. The emergency room nurse loads the flash drive and accepts the electronic copy of the problem list, allergies and medication list into the on-site record. The software extract manages the differences in information model design between EHR vendors by crosschecking the allergy list with information in the problem list and encounter diagnoses.
After an otoscopic exam, the patient is diagnosed with acute otitis media. The emergency room physician enters an electronic order for “875 mg amoxiliin with clavulanate 125 mg orally twice daily”, the drug of choice for acute otitis in adults. When the physician presses ‘Enter’ to commit the order, a pop-up alert is generated by the EHR with warning that this patient has had an allergic reaction to penicillin and has a high likelihood of cross reacting. While studying the alert, the physician notes that the supporting information was gleaned from the problem list and allergy list. The EHR drug interaction software has cross-referenced the chemical composition of amoxillin/ clavulanate and noted amoxiliin to be a penicillin derivative. The physician decides that the information of penicillin allergy is credible and as the patient has taken cephalosporins in the past without issues, the physician changes his order to Cefuroxime, 500 mg orally twice daily.
Last updated