ATHENA
Fetch patient allergies
Read one patient's allergy records and explicit NKDA state from Athena preview.
POSThttps://api.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
Substance id
allergies[].substance_code
string
Substance code
allergies[].substance_type
string
Substance type
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 allergy reaction id
allergies[].reactions[].name
string
Reaction name recorded in Athena.
Example
"Sneezing"allergies[].reactions[].code
string
Code
allergies[].reactions[].code_set
string
Code set
allergies[].reactions[].severity_code
string
Severity code
allergies[].reactions[].severity_code_set
string
Severity code set
allergies[].reactions[].severity_display
string
Severity display
allergies[].reactions[].created_at
string
Created at
allergies[].reactions[].last_modified_at
string
Last modified at
allergies[].created_at
string
Created at
allergies[].last_modified_at
string
Last modified at
allergies[].deactivated_at
string
Deactivated at
Code
curl --request POST \
--url https://api.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"
}