Skip to main content

AllergyIntolerance

Overview​

The AllergyIntolerance resource provides information about a patient's risk of harmful or undesirable physiological responses to specific substances. This includes allergies, intolerances, and adverse reactions that are critical for safe patient care.

Resource Schema​

Key fields in the AllergyIntolerance resource:

{
  "resourceType": "AllergyIntolerance",
  "id": "example-allergy-123",
  "clinicalStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical",
        "code": "active"
      }
    ]
  },
  "verificationStatus": {
    "coding": [
      {
        "system": "http://terminology.hl7.org/CodeSystem/allergyintolerance-verification",
        "code": "confirmed"
      }
    ]
  },
  "type": "allergy",
  "category": ["medication"],
  "criticality": "high",
  "code": {
    "coding": [
      {
        "system": "http://www.nlm.nih.gov/research/umls/rxnorm",
        "code": "7980",
        "display": "Penicillin"
      }
    ]
  },
  "patient": {
    "reference": "Patient/123456"
  }
}

Operations​

The AllergyIntolerance resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

Retrieves a specific AllergyIntolerance resource by ID.

HTTP Method: GET
URL: /AllergyIntolerance/{id}

Examples​

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/AllergyIntolerance/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Retrieves AllergyIntolerance resources matching specified criteria.

HTTP Method: GET or POST
URL: /AllergyIntolerance or /AllergyIntolerance/_search

Search Parameters​

Patient-based Search:

ParameterTypeRequiredDescriptionExample
patientreferenceYesREQUIRED Who the sensitivity is forpatient=value
clinical-statusstringNoClinical status of the AllergyIntolerance. Possible values are: active, inactive, or resolvedclinical-status=value
pagestringNoZero-based page indexpage=value
_revincludespecialNoInclude Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"_revinclude=value

ID-based Search:

ParameterTypeRequiredDescriptionExample
clinical-statusstringNoClinical status of the AllergyIntolerance. Possible values are: active, inactive, or resolvedclinical-status=value
pagestringNoZero-based page indexpage=value
_revincludespecialNoInclude Provenance resource(s) that reference the matched search results. Allowed: "Provenance:target"_revinclude=value

Examples​

POST Method (Recommended)​
Search by Patient
curl -X POST https://fhir.netsmartcloud.com/uscore/v1/AllergyIntolerance/_search \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json" \
    -H "Content-Type: application/x-form-urlencoded" \
    -d "patient=Patient/123"
GET Method​
Search by Patient
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/AllergyIntolerance?patient=Patient/123 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns​

Common Workflows​

  1. Allergy Check - Retrieve all allergies for a patient before prescribing
  2. Safety Screening - Check for specific substance allergies
  3. Clinical Decision Support - Use allergy data for medication reconciliation

Relationships to Other Resources​

The AllergyIntolerance resource relates to:

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​

Profiles supported by this resource (as defined in the CapabilityStatement):