Tross
ATHENA

Fetch patient open orders

Read open orders from one Athena preview chart, with an optional exact ID filter.

POSThttps://api.ontross.com/api/integrations/athena/fetch-patient-open-orders
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
input.limit
integer
required
Maximum matching open orders returned from this source response.
Example
1
input.order_id
string
Order id
Example
"12345"
input.offset
integer
Local offset; each request refetches the source, so pages are not a stable snapshot.
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
Practice patient ID used for this read.
Example
"842701"
chart_id
string
Resolved Athena chart ID.
Example
"920415"
order_id
string
Order id
limit
integer
Local page size requested by the caller.
Example
1
offset
integer
Local offset requested by the caller.
Example
0
total_matching
integer
Open orders matching the optional ID filter before local paging.
Example
2
has_more
boolean
Whether this fetched response has matching orders after the returned slice.
Example
true
next_offset
integer
Next offset
orders
array
Open orders in this local page; no result data is included.
orders[].source_id
string
Identifier of the open order in Athena.
Example
"74821"
orders[].source_status
string
Order status exactly as supplied by Athena; this operation reads open orders only.
Example
"REVIEW"
orders[].display_name
string
Order name displayed in the chart.
Example
"Lipid panel"
orders[].description
string
Description
orders[].order_type_id
string
Order type id
orders[].order_type_name
string
Order type name
orders[].code
string
Code
orders[].code_set
string
Code set
orders[].code_description
string
Code description
orders[].provider_order_type_id
string
Provider order type id
orders[].provider_order_type_name
string
Provider order type name
orders[].provider_loinc
string
Provider loinc
orders[].electronic_order_code
string
Electronic order code
orders[].order_date
string
Order date
orders[].encounter_date
string
Encounter date
orders[].created_at
string
Created at
orders[].approved_at
string
Approved at
orders[].encounter_id
string
Encounter id
orders[].created_encounter_id
string
Created encounter id
orders[].accession_id
string
Accession id
orders[].source
string
Source
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/athena/fetch-patient-open-orders \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"department_id":12,"limit":1,"offset":0,"org_id":64200,"patient_id":842701},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "department_id": 12,
    "limit": 1,
    "offset": 0,
    "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": {
    "chart_id": "920415",
    "has_more": true,
    "limit": 1,
    "next_offset": 1,
    "offset": 0,
    "orders": [
      {
        "code": "24331-1",
        "code_description": "Lipid panel - Serum or Plasma",
        "code_set": "LOINC",
        "created_at": "2026-03-10T11:20:00-04:00",
        "created_encounter_id": "42018",
        "description": "Lipid panel, serum",
        "display_name": "Lipid panel",
        "encounter_id": "42018",
        "order_date": "2026-03-10T11:20:00-04:00",
        "order_type_id": "421",
        "order_type_name": "Lipid panel",
        "provider_loinc": "24331-1",
        "provider_order_type_id": "482",
        "provider_order_type_name": "Lipid panel",
        "source": "chart",
        "source_id": "74821",
        "source_status": "REVIEW"
      }
    ],
    "patient_id": "842701",
    "total_matching": 2
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}