Tross
ATHENA

Fetch patient lab results

Read one patient chart's lab-result documents from the preview Athena portal.

POSThttps://api.ontross.com/api/integrations/athena/fetch-patient-lab-results
Request Fields
input.org_id
integer
required
Athena practice ID.
Example
32817
input.department_id
integer
required
Chart department ID.
Example
4
input.patient_id
integer
required
Practice patient ID.
Example
913
input.limit
integer
Maximum records from one bounded source response.
Example
10
Default
25
input.offset
integer
Local offset; pages refetch the source.
Example
0
Default
0
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
Requested practice patient ID.
Example
"913"
chart_id
string
Resolved chart ID.
Example
"2346"
results
array
Lab-result documents in source order.
results[].source_id
string
Result document ID.
Example
"24213"
results[].clinical_result_id
string
Clinical result ID.
Example
"57021"
results[].status
string
Document workflow status (NEW/REVIEW/CLOSED).
Example
"REVIEW"
results[].result_status
string
Result status (final/preliminary).
Example
"final"
results[].result_category
string
Abnormal/normal category as Athena labels it.
Example
"abnormal"
results[].name
string
Result/order type name.
Example
"Urine drug screen"
results[].code
string
Primary result code.
Example
"57021-8"
results[].code_set
string
Coding system for the primary code.
Example
"LOINC"
results[].order_type_id
string
Clinical order type ID.
Example
"643"
results[].observation_date
string
Specimen collected date.
Example
"2026-09-24"
results[].reported_date
string
Result reported date.
Example
"2026-09-25"
results[].performing_lab
string
Performing lab / clinical provider name.
Example
"Example Regional Laboratory"
results[].ordering_provider
string
Ordering provider username, when present.
Example
"jhale42"
results[].tie_to_order_id
string
Order document the result ties to.
Example
"23905"
results[].encounter_id
string
Encounter the result belongs to.
Example
"43129"
results[].specimen_source
string
Specimen source, when present.
Example
"Urine"
results[].has_attachment
boolean
Whether the result document has a scanned attachment.
Example
true
total_matching
integer
Records in the one source response.
Example
7
limit
integer
Requested local page size.
Example
10
offset
integer
Requested local offset.
Example
0
has_more
boolean
Whether that source response has more records.
Example
false
next_offset
integer
Next local offset, when present.
Example
10
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/athena/fetch-patient-lab-results \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"department_id":4,"limit":10,"offset":0,"org_id":32817,"patient_id":913},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "department_id": 4,
    "limit": 10,
    "offset": 0,
    "org_id": 32817,
    "patient_id": 913
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient_id": "913",
    "chart_id": "2346",
    "results": [
      {
        "source_id": "24213",
        "clinical_result_id": "57021",
        "status": "REVIEW",
        "result_status": "final",
        "result_category": "abnormal",
        "name": "Urine drug screen",
        "code": "57021-8",
        "code_set": "LOINC",
        "order_type_id": "643",
        "observation_date": "2026-09-24",
        "reported_date": "2026-09-25",
        "performing_lab": "Example Regional Laboratory",
        "ordering_provider": "jhale42",
        "tie_to_order_id": "23905",
        "encounter_id": "43129",
        "specimen_source": "Urine",
        "has_attachment": true
      }
    ],
    "total_matching": 7,
    "limit": 10,
    "offset": 0,
    "has_more": false,
    "next_offset": 10
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}