Home
FHIR® API actions
General clinical
Retrieve a patient's allergies

Retrieve a patient's allergies

You can use this API action to access a list of patient allergies, as documented by a specific organization. A patient can have an allergy to medication, food, or materials, to name a few.

Use cases

This API action may be a good fit for your organization if you perform any of these use cases:

  • Decide or know the appropriate medication dosages for a patient’s allergies.
  • Understand a patient’s environmental allergies (e.g., latex allergy).

Supported systems

You can use this API action with the Redox FHIR® API.

Your connection's system can return results with their own FHIR® or query-based API. 

Things you need to know

Action steps

Prerequisites

The following actions must be completed before attempting the steps below.

Steps
  • 1
    Retrieve a patient's allergies
    required

This table has notes about how to use parameters for this API action specifically, but it's not exhaustive. Refer to the AllergyIntolerance resource schema for more details.

Query parameter
Required
Notes
patient.identifier
Y
You must include at least one identifier for the patient that the EHR system uses. If you don't have a patient identifier, search for a patient with demographics to find one.
clinical-status
N
You can refine your search by searching specifically for a patient's active, inactive, or resolved allergies).

The response contains one or more allergies for an individual patient. In a FHIR® response, you can find the total number of included allergies in the total array.

You could also receive an empty response body with no listed allergies. This doesn’t necessarily mean that the patient is allergy-free; it only means that the organization hasn’t documented any known allergies for the patient.

The returned data fields that should help inform your workflow the most are the clinicalStatus[] and reaction[] arrays.

AllergyIntolerance/_search
curl 'https://api.redoxengine.com/fhir/R4/redox-fhir-sandbox/Development/AllergyIntolerance/_search' \
--request POST \
--header 'Authorization: Bearer ${API_TOKEN}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'patient=Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7' \
--data-urlencode 'clinical-status=active'
{
  "id": "4c1f0116-1912-4a98-be85-3658d1b239bb",
  "type": "searchset",
  "entry": [
    {
      "search": {
        "mode": "match",
        "score": 1
      },
      "resource": {
        "id": "9d91915b-c4d5-4e45-a4fb-9c6ba5a302b6",
        "code": {
          "coding": [
            {
              "code": "227493005",
              "system": "http://snomed.info/sct",
              "display": "Cashew nuts"
            }
          ]
        },
        "meta": {
          "lastUpdated": "2022-12-02T19:29:10.510Z"
        },
        "note": [
          {
            "text": "The criticality is high because of the observed anaphylactic reaction when challenged with cashew extract."
          }
        ],
        "type": "allergy",
        "patient": {
          "reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"
        },
        "asserter": {
          "reference": "Patient/81c2f5eb-f99f-40c4-b504-59483e6148d7"
        },
        "category": [
          "food"
        ],
        "reaction": [
          {
            "onset": "2012-06-12T00:00:00.000Z",
            "severity": "severe",
            "substance": {
              "coding": [
                {
                  "code": "1160593",
                  "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
                  "display": "cashew nut allergenic extract Injectable Product"
                }
              ]
            },
            "description": "Challenge Protocol. Severe reaction to subcutaneous cashew extract. Epinephrine administered",
            "exposureRoute": {
              "coding": [
                {
                  "code": "34206005",
                  "system": "http://snomed.info/sct",
                  "display": "Subcutaneous route"
                }
              ]
            },
            "manifestation": [
              {
                "coding": [
                  {
                    "code": "39579001",
                    "system": "http://snomed.info/sct",
                    "display": "Anaphylactic reaction"
                  }
                ]
              }
            ]
          },
          {
            "note": [
              {
                "text": "The patient reports that the onset of urticaria was within 15 minutes of eating cashews."
              }
            ],
            "onset": "2004-01-01T00:00:00.000Z",
            "severity": "moderate",
            "manifestation": [
              {
                "coding": [
                  {
                    "code": "64305001",
                    "system": "http://snomed.info/sct",
                    "display": "Urticaria"
                  }
                ]
              }
            ]
          }
        ],
        "recorder": {
          "reference": "Practitioner/dbed0f85-e3cd-47ac-9305-3f629e138832"
        },
        "identifier": [
          {
            "value": "88779966",
            "system": "http://acme.com/ids/patients/risks"
          }
        ],
        "criticality": "high",
        "recordedDate": "2014-10-09T00:00:00.000Z",
        "resourceType": "AllergyIntolerance",
        "onsetDateTime": "2004-01-01T00:00:00.000Z",
        "clinicalStatus": {
          "coding": [
            {
              "code": "active",
              "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
              "display": "Active"
            }
          ]
        },
        "lastOccurrence": "2012-06-01T00:00:00.000Z",
        "verificationStatus": {
          "coding": [
            {
              "code": "confirmed",
              "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
              "display": "Confirmed"
            }
          ]
        }
      }
    }
  ],
  "total": 1,
  "resourceType": "Bundle"
}