Tross
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
required
Athena practice ID for the saved authentication.
Example
64200
input.department_id
integer
required
Department containing the patient's chart.
Example
12
input.patient_id
integer
required
Practice patient ID, not the chart or enterprise ID.
Example
842701
auth_id
string
required
Saved 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
false
state
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"
}