---
title: Retrieve Allergy Intolerance
slug: retrieve-allergy-intolerance
docTags: 
createdAt: 2023-09-12T11:08:47.786Z
---

Retrieve a patient's allergies and intolerances directly from the EHR. Essential for understanding sensitivities, this data aids applications in ensuring patient safety and tailored care plans.

To access this clinical data you'll need the patient identifier, obtainable through the [Retrieve Patient](docId:8OPknnbMTaZ47Rk5HkDD3) interaction.

:::hint{type="info"}
**Clinical Warning:&#x20;**&#x46;ounda can only retrieve the allergies and/or intolerances that are registered for this patient at the integrated healthcare provider. If there is an empty response, that does not always mean that the patient doesn't have any allergies and/or intolerances. It only means that there are none registered at this healthcare provider.
:::

### Interaction

Retrieving the list of allergies and/or intolerances can be done by sending a **GET** request. The request is sent to the AllergyIntolerance endpoint:

`https://api.<region>.founda.com/1/health/organizations/<org-x>/fhir/4/AllergyIntolerance?<parameters>`

Where `<region>` should be defined according to the different Founda [regions](docId\:ncFf15xNu1WGlST2wNm-P) and `<org-x>` should be replaced with the Healthcare Provider's organization ID that you are integrated with.&#x20;

The response contains a Bundle with 0, 1 or N matching AllergyIntolerances. The full AllergyIntolerance resource can be retrieved with the identifier of the selected AllergyIntolerance from the result set.&#x20;

### Profile

Founda adheres to recognized standards (IHE, HL7 FHIR) to ensure compatibility and harmonization among diverse systems. If there is a profile available for an interaction, it is recommended and preferred to follow the prescribed transactions.

The Retrieve Allergy Intolerance interaction with the Founda Platform is based on the [IHE QEDm profile](https://www.ihe.net/uploadedFiles/Documents/PCC/IHE_PCC_Suppl_QEDm.pdf). To indicate that the request and response should comply with PCC-44, the `_profile` parameter should be included to the search set: `.../AllergyIntolerance?_profile=https://profiles.ihe.net/ITI/QEDm`.

### Parameters

In order to comply with the PCC-44 transaction, the interaction should at least support the parameter in the table below. Additional search parameters, as defined in the [FHIR AllergyIntolerance](http://hl7.org/fhir/allergyintolerance.html) resource, can be used as well.&#x20;

| **Parameter** | **Type**    | **Required** | **Description**                                                  |
| ------------- | ----------- | ------------ | ---------------------------------------------------------------- |
| `patient`     | `reference` | Y            | The patient to retrieve the Allergy and Intolerance overview for |

### Example API call

::::CodeDrawer{title="Retrieve AllergyIntolerance for Patient" isResponseExpanded="true" autoGeneratedAnchorSlug="retrieve-allergyintolerance-for-patient" legacyHash="JGAb6waoPBMUOiJEWSVm8"}
:::CodeblockTabsExamples
```curl
curl --location 'https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/AllergyIntolerance?patient=2078&_profile=https%3A%2F%2Fprofiles.ihe.net%2FITI%2FQEDm%2F' \
--header 'Authorization: Bearer ory_at_T_sx5CEqgi37wTaptEkGAV9Ggsg4UCzrzOc4Xe29Sto.jfqRUlKTeevVwUmPD6djKD2lAWDh5vRMfIf0PKpNQsU' \
--data ''
```
:::

:::CodeblockTabsResponses
```javascript
{
    "resourceType": "Bundle",
    "id": "9c4e3368-4b80-4bbf-968f-4d8056060fd0",
    "meta": {
        "lastUpdated": "2023-10-17T09:13:41.632+00:00"
    },
    "type": "searchset",
    "total": 1,
    "link": [
        {
            "relation": "self",
            "url": "https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/AllergyIntolerance?patient=2078&_profile=https://profiles.ihe.net/ITI/QEDm/"
        }
    ],
    "entry": [
        {
            "fullUrl": "https://api.eu.founda.com/1/health/organizations/org-4c5739ba994d4ce9b5255d3f84a2d367/fhir/4/AllergyIntolerance/2156",
            "resource": {
                "resourceType": "AllergyIntolerance",
                "id": "2156",
                "meta": {
                    "versionId": "1",
                    "lastUpdated": "2023-10-05T14:29:18.114+00:00",
                    "source": "#tv3ROuOimBgqv1s0",
                    "tag": [
                        {
                            "system": "http://terminology.hl7.org/CodeSystem/v3-ActReason",
                            "code": "HTEST",
                            "display": "test health data"
                        }
                    ]
                },
                "text": {
                    "status": "generated",
                    "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p><b>Generated Narrative with Details</b></p><p><b>id</b>: example</p><p><b>identifier</b>: 49476534</p><p><b>clinicalStatus</b>: Active <span>(Details : {http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical code 'active' = 'Active', given as 'Active'})</span></p><p><b>verificationStatus</b>: Confirmed <span>(Details : {http://terminology.hl7.org/CodeSystem/allergyintolerance-verification code 'confirmed' = 'Confirmed', given as 'Confirmed'})</span></p><p><b>type</b>: allergy</p><p><b>category</b>: food</p><p><b>criticality</b>: high</p><p><b>code</b>: Cashew nuts <span>(Details : {SNOMED CT code '227493005' = 'Cashew nuts', given as 'Cashew nuts'})</span></p><p><b>patient</b>: <a>Patient/example</a></p><p><b>onset</b>: 01/01/2004</p><p><b>recordedDate</b>: 09/10/2014 2:58:00 PM</p><p><b>recorder</b>: <a>Practitioner/example</a></p><p><b>asserter</b>: <a>Patient/example</a></p><p><b>lastOccurrence</b>: 01/06/2012</p><p><b>note</b>: The criticality is high becasue of the observed anaphylactic reaction when challenged with cashew extract.</p><blockquote><p><b>reaction</b></p><p><b>substance</b>: cashew nut allergenic extract Injectable Product <span>(Details : {RxNorm code '1160593' = 'cashew nut allergenic extract Injectable Product', given as 'cashew nut allergenic extract Injectable Product'})</span></p><p><b>manifestation</b>: Anaphylactic reaction <span>(Details : {SNOMED CT code '39579001' = 'Anaphylaxis', given as 'Anaphylactic reaction'})</span></p><p><b>description</b>: Challenge Protocol. Severe reaction to subcutaneous cashew extract. Epinephrine administered</p><p><b>onset</b>: 12/06/2012</p><p><b>severity</b>: severe</p><p><b>exposureRoute</b>: Subcutaneous route <span>(Details : {SNOMED CT code '34206005' = 'Subcutaneous route', given as 'Subcutaneous route'})</span></p></blockquote><blockquote><p><b>reaction</b></p><p><b>manifestation</b>: Urticaria <span>(Details : {SNOMED CT code '64305001' = 'Urticaria', given as 'Urticaria'})</span></p><p><b>onset</b>: 01/01/2004</p><p><b>severity</b>: moderate</p><p><b>note</b>: The patient reports that the onset of urticaria was within 15 minutes of eating cashews.</p></blockquote></div>"
                },
                "identifier": [
                    {
                        "system": "http://acme.com/ids/patients/risks",
                        "value": "49476534"
                    }
                ],
                "clinicalStatus": {
                    "coding": [
                        {
                            "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
                            "code": "active",
                            "display": "Active"
                        }
                    ]
                },
                "verificationStatus": {
                    "coding": [
                        {
                            "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
                            "code": "confirmed",
                            "display": "Confirmed"
                        }
                    ]
                },
                "type": "allergy",
                "category": [
                    "food"
                ],
                "criticality": "high",
                "code": {
                    "coding": [
                        {
                            "system": "http://snomed.info/sct",
                            "code": "227493005",
                            "display": "Cashew nuts"
                        }
                    ]
                },
                "patient": {
                    "reference": "Patient/2078"
                },
                "onsetDateTime": "2004",
                "recordedDate": "2014-10-09T14:58:00+11:00",
                "recorder": {
                    "reference": "Practitioner/2079"
                },
                "asserter": {
                    "reference": "Patient/2078"
                },
                "lastOccurrence": "2012-06",
                "note": [
                    {
                        "text": "The criticality is high becasue of the observed anaphylactic reaction when challenged with cashew extract."
                    }
                ],
                "reaction": [
                    {
                        "substance": {
                            "coding": [
                                {
                                    "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                                    "code": "1160593",
                                    "display": "cashew nut allergenic extract Injectable Product"
                                }
                            ]
                        },
                        "manifestation": [
                            {
                                "coding": [
                                    {
                                        "system": "http://snomed.info/sct",
                                        "code": "39579001",
                                        "display": "Anaphylactic reaction"
                                    }
                                ]
                            }
                        ],
                        "description": "Challenge Protocol. Severe reaction to subcutaneous cashew extract. Epinephrine administered",
                        "onset": "2012-06-12",
                        "severity": "severe",
                        "exposureRoute": {
                            "coding": [
                                {
                                    "system": "http://snomed.info/sct",
                                    "code": "34206005",
                                    "display": "Subcutaneous route"
                                }
                            ]
                        }
                    },
                    {
                        "manifestation": [
                            {
                                "coding": [
                                    {
                                        "system": "http://snomed.info/sct",
                                        "code": "64305001",
                                        "display": "Urticaria"
                                    }
                                ]
                            }
                        ],
                        "onset": "2004",
                        "severity": "moderate",
                        "note": [
                            {
                                "text": "The patient reports that the onset of urticaria was within 15 minutes of eating cashews."
                            }
                        ]
                    }
                ]
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}
```
:::
::::

