For AI agents: the documentation index is at /docs/payerbox/llms.txt. A Markdown version of this page is available at /docs/payerbox/data-integration/uscdi/allergies.md or by requesting it with the Accept: text/markdown header.
Payerbox Docs

Allergies and Intolerances

Datasets

US Core 6.1.0 maps each USCDI element to FHIR.

DatasetUS Core 6.1.0 target profile(s)
allergiesUS Core AllergyIntolerance

allergies

One row per substance per patient. A substance with several reaction manifestations stays one row: list the manifestation codes ;-separated.

ColumnRequiredFormat / valuesExample
patient_identifierYespatient keyMRN-4471903
substance_codeYesRxNorm ingredient or SNOMED CT code, with substance_system; RxNorm if omitted Common substances for allergy and intolerance documentation including refutations7980 penicillin G
clinical_statusYes, unless verification_status is entered-in-erroractive, inactive, resolved allergyintolerance-clinicalactive
verification_statusRecommendedunconfirmed, confirmed, refuted, entered-in-error allergyintolerance-verificationconfirmed
categoryIf availablefood, medication, environment, biologic allergy-intolerance-categorymedication
criticalityIf availablelow, high, unable-to-assess allergy-intolerance-criticalityhigh
reaction_manifestation_codeIf a reaction is recordedSNOMED CT code(s), ;-separated SNOMED CT Clinical Findings247472004 Wheal
onset_dateIf availabledatetime2019-05-02
  • substance_code is the one coded field with no fallback: a row without it cannot become an AllergyIntolerance. Send substance_system as http://www.nlm.nih.gov/research/umls/rxnorm or http://snomed.info/sct.
  • For a medication, send the ingredient. Every RxNorm code the value set accepts is an ingredient, single or combination. A code for a specific product or pack, whether an NDC or an RxNorm drug-level code from a pharmacy claim, is not accepted, so roll it up to the ingredient first. For an allergy recorded against a whole drug class, send the SNOMED CT class code.
  • A row that carries a reaction needs at least one reaction_manifestation_code. Manifestation is mandatory inside a reaction.
  • clinical_status and verification_status are coupled: FHIR requires clinical_status on every row whose verification_status is not entered-in-error, and forbids it on rows that are. A row that leaves both empty is rejected. Sending active on live rows and resolved or inactive on closed ones satisfies this.

No known allergies

An empty file is ambiguous: it does not separate "we asked, the member has no allergies" from "we never asked". US Core states either case as a row carrying a negation code, and the value set holds one per substance class.

Meaningsubstance_codeclinical_statusverification_status
No known allergies at all716186003 No known allergyactiveconfirmed
No known drug allergies409137002 No known drug allergyactiveconfirmed
No known food allergies429625007 No known food allergyactiveconfirmed
No known environmental allergies428607008 No known environmental allergyactiveconfirmed
No known latex allergy1003774007 No known latex allergyactiveconfirmed
Member was not asked1631000175102 Patient not askedactiveunconfirmed, or empty

All six are SNOMED CT. Use the narrowest one your source supports: a plan that only knows "no drug allergies" should send 409137002, not 716186003.

These resources are served by Patient Access, Provider Access, Payer-to-Payer, and Prior Auth.

Last updated: