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

Retrieve a patient's allergies

A patient can have an allergy to medication, food, or materials, to name a few. If you want to access a patient’s current allergies—as documented by a specific organization—you can use this API action to retrieve a list. Typically, you can use this for:

  • determining appropriate medication dosages for a patient’s allergies; or
  • understanding 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's used by the EHR system you're querying. If you don't have a patient identifier, you can find one by searching for a patient with demographics.
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 medications in the total array.

It’s also possible that you 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.

Query Response
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"
}