Tross
ATHENA

Fetch chart messages

List the staff messages about a patient.

POSThttps://api.ontross.com/api/integrations/athena/fetch-chart-messages
Request Fields
input.org_id
integer
required
Athena practice ID.
Example
32817
input.department_id
integer
required
Chart department ID.
Example
1
input.patient_id
integer
required
Practice patient ID.
Example
1133
input.limit
integer
Maximum messages returned, newest first.
Example
25
Default
25
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
"1133"
messages
array
Messages about the patient, newest first.
messages[].message_id
string
Athena message ID.
Example
"12128"
messages[].subject
string
Message subject.
Example
"Lab follow-up"
messages[].to
string
Recipient as the list shows it (a user or role label).
Example
"Assigned Therapist"
messages[].priority
string
Priority as the list shows it.
Example
"NORMAL"
messages[].sent_at
string
Timestamp as the list shows it.
Example
"10/29/26 06:01 AM"
messages[].sort_value
string
Athena's sortable timestamp for the row.
Example
"20261029060145"
total
integer
Messages in the list before the limit.
Example
2
Code
curl curl %s %s POST \
  --url https://api.ontross.com/api/integrations/athena/fetch-chart-messages \
  %s %s 'X-API-Key: REPLACE_KEY_VALUE' \
  %s %s 'content-type: application/json' \
  %s %s '{"input":{"department_id":1,"limit":25,"org_id":32817,"patient_id":1133},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "department_id": 1,
    "limit": 25,
    "org_id": 32817,
    "patient_id": 1133
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient_id": "1133",
    "messages": [
      {
        "message_id": "12128",
        "subject": "Lab follow-up",
        "to": "Assigned Therapist",
        "priority": "NORMAL",
        "sent_at": "10/29/26 06:01 AM",
        "sort_value": "20261029060145"
      }
    ],
    "total": 2
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}