ATHENA
Fetch patient allergies
Read one patient's allergy records and explicit NKDA state from Athena preview.
POSThttps://preview.ontross.com/api/integrations/athena/fetch-patient-allergies
Request Fields
input.org_id
integer
requiredAthena practice ID for the saved authentication.
Example
64200input.department_id
integer
requiredDepartment containing the patient's chart.
Example
12input.patient_id
integer
requiredPractice patient ID, not the chart or enterprise ID.
Example
842701auth_id
string
requiredSaved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"Output Fields
patient_id
string
Practice patient ID used for this read.
Example
"842701"chart_id
string
Resolved Athena chart ID.
Example
"920415"nkda_checked
boolean
Whether Athena explicitly marked no known drug allergies.
Example
falsestate
string
Present when records exist; no_known_allergies only for an empty list with NKDA checked; otherwise unknown.
Example
"present"allergies
array
Allergy records in the chart briefing.
allergies[].source_id
string
Identifier of the patient allergy record in Athena.
Example
"540321"allergies[].chart_id
string
Chart containing this allergy record.
Example
"920415"allergies[].name
string
Allergy name shown in the chart.
Example
"Grass pollen"allergies[].substance_name
string
Substance named by the allergy record.
Example
"Grass pollen"allergies[].substance_id
string
Source substance identifier, when supplied.
Example
"48126"allergies[].substance_code
string
Source substance code, when supplied.
Example
"GP-001"allergies[].substance_type
string
Source substance classification, when supplied.
Example
"Environmental"allergies[].reactions
array
Recorded reactions and any source severity details.
allergies[].reactions[].source_id
string
Reaction identifier in Athena's allergy record.
Example
"540322"allergies[].reactions[].patient_allergy_reaction_id
string
Patient-specific reaction identifier, when supplied.
Example
"540322"allergies[].reactions[].name
string
Reaction name recorded in Athena.
Example
"Sneezing"allergies[].reactions[].code
string
Reaction code, when supplied.
Example
"76067001"allergies[].reactions[].code_set
string
Coding system for the reaction code.
Example
"SNOMED CT"allergies[].reactions[].severity_code
string
Source severity code, when supplied.
Example
"1"allergies[].reactions[].severity_code_set
string
Coding system for the severity code.
Example
"local"allergies[].reactions[].severity_display
string
Source severity label, when supplied.
Example
"Mild"allergies[].reactions[].created_at
string
Source creation timestamp, when supplied.
Example
"2026-03-10T09:15:00-04:00"allergies[].reactions[].last_modified_at
string
Source modification timestamp, when supplied.
Example
"2026-03-10T09:15:00-04:00"allergies[].created_at
string
Source creation timestamp, when supplied.
Example
"2026-03-10T09:15:00-04:00"allergies[].last_modified_at
string
Source modification timestamp, when supplied.
Example
"2026-03-10T09:15:00-04:00"allergies[].deactivated_at
string
Source deactivation timestamp, when supplied; no status is inferred from its absence.
Example
"2026-04-01T09:00:00-04:00"Code
curl --request POST \
--url https://preview.ontross.com/api/integrations/athena/fetch-patient-allergies \
--header 'X-API-Key: REPLACE_KEY_VALUE' \
--header 'content-type: application/json' \
--data '{"input":{"department_id":12,"org_id":64200,"patient_id":842701},"auth_id":"auth_uuid_here"}'Request BODY
{
"input": {
"department_id": 12,
"org_id": 64200,
"patient_id": 842701
},
"auth_id": "auth_uuid_here"
}Response BODY
{
"id": "string",
"workflow_id": "string",
"auth_id": "string",
"status": "string",
"input": {},
"output": {
"allergies": [
{
"chart_id": "920415",
"created_at": "2026-03-10T09:15:00-04:00",
"last_modified_at": "2026-03-10T09:15:00-04:00",
"name": "Grass pollen",
"reactions": [
{
"code": "76067001",
"code_set": "SNOMED CT",
"name": "Sneezing",
"patient_allergy_reaction_id": "540322",
"severity_display": "Mild",
"source_id": "540322"
}
],
"source_id": "540321",
"substance_id": "48126",
"substance_name": "Grass pollen",
"substance_type": "Environmental"
}
],
"chart_id": "920415",
"nkda_checked": false,
"patient_id": "842701",
"state": "present"
},
"files": null,
"created_at": "2019-08-24T14:15:22Z",
"started_at": "2019-08-24T14:15:22Z",
"completed_at": "2019-08-24T14:15:22Z"
}