Athena Prod Fetch patient treatment plan

POSThttps://preview.ontross.com/api/integrations/athena-prod/fetch-patient-treatment-plan

input.org_id

integer

required

Practice context, shown in the athenanet portal URL.

Example

25910

input.department_id

integer

required

Department the session opens, shown in the portal URL.

Example

1

input.patient_id

integer

required

Patient whose chart is read or written, from the chart URL.

Example

1

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"

treatment_plan_summary

object

Treatment-plan audit and review summary.

treatment_plan_summary.added_timestamp

string

ISO-8601 timestamp when the treatment plan was added.

Example

"2026-10-09T14:30:00.000Z"

treatment_plan_summary.added_by

string

Name of the user who added the treatment plan.

Example

"Morgan Ellis"

treatment_plan_summary.review_due_date

string

ISO-8601 treatment-plan review due date.

Example

"2026-11-15T05:00:00.000Z"

treatment_plan_summary.last_action_by

string

Name of the user who last changed the treatment plan.

Example

"Morgan Ellis"

treatment_plan_summary.last_action_timestamp

string

ISO-8601 timestamp of the last treatment-plan change.

Example

"2026-10-12T15:45:00.000Z"

concerns_data

array

Treatment-plan concerns and their linked goals.

concerns_data[].id

string

Athena health-concern problem identifier.

Example

"909107"

concerns_data[].concern

string

Concern or problem name.

Example

"Anxiety"

concerns_data[].is_active

boolean

Whether the concern is active; Athena marks Achieved concerns as inactive.

Example

true

concerns_data[].associated_diagnoses

string

Comma-separated diagnosis codes and descriptions.

Example

"F41.1 Generalized anxiety disorder"

concerns_data[].as_evidenced_by

string

Symptom, note, or observation supporting the concern.

Example

"Reports persistent worry and difficulty falling asleep."

concerns_data[].goals

array

Names of goals linked to this concern.

concerns_data[].goals_text

string

Pipe-delimited representation of linked goal names.

Example

"Manage anxiety more effectively|Improve sleep habits"

concerns_data[].added_by

string

Name of the user who added the concern.

Example

"Morgan Ellis"

concerns_data[].added_at

string

Formatted date and time when the concern was added.

Example

"10-09-2026 10:30am"

concerns_data[].last_action_by

string

Name of the user who last changed the concern.

Example

"Morgan Ellis"

concerns_data[].last_action_at

string

Formatted date and time of the last concern change.

Example

"10-12-2026 11:45am"

concerns_data[].list_menu

boolean

Whether the concern supports row-level menu actions.

Example

true

client_characteristics

array

Athena patient characteristic observations.

client_characteristics[].ObservationId

string

Athena observation identifier.

Example

"909284"

client_characteristics[].TypeName

string

Characteristic category, such as Strength, Barrier, or Ability.

Example

"Strength"

client_characteristics[].Summary

string

Characteristic description.

Example

"Participates in treatment planning"

client_characteristics[].Archived

boolean

Whether the observation is archived.

Example

false

client_characteristics[].HealthConcerns

array

Health concerns linked to the observation.

client_characteristics[].HealthConcerns[].HealthConcernId

string

Athena health-concern identifier.

Example

"9064"

client_characteristics[].HealthConcerns[].SnomedCode

string

SNOMED code associated with the health concern.

Example

"48694002"

client_characteristics[].Created

string

ISO-8601 timestamp when the observation was created.

Example

"2026-10-09T14:30:00.000Z"

client_characteristics[].CreatedBy

object

User who created the observation.

client_characteristics[].CreatedBy.Id

string

Athena user identifier.

Example

"90871"

client_characteristics[].CreatedBy.FirstName

string

User first name.

Example

"Morgan"

client_characteristics[].CreatedBy.LastName

string

User last name.

Example

"Ellis"

client_characteristics[].CreatedBy.Suffix

string

User name suffix, when present.

Example

"Jr."

client_characteristics[].LastModified

string

ISO-8601 timestamp of the last modification.

Example

"2026-10-12T15:45:00.000Z"

client_characteristics[].LastModifiedBy

object

User who last modified the observation.

client_characteristics[].LastModifiedBy.Id

string

Athena user identifier.

Example

"90871"

client_characteristics[].LastModifiedBy.FirstName

string

User first name.

Example

"Morgan"

client_characteristics[].LastModifiedBy.LastName

string

User last name.

Example

"Ellis"

client_characteristics[].LastModifiedBy.Suffix

string

User name suffix, when present.

Example

"Jr."

goals

array

Treatment-plan goals with independent objective and intervention collections.

goals[].goal_id

string

Athena goal identifier.

Example

"9086"

goals[].goal_name

string

Goal name.

Example

"Manage anxiety more effectively"

goals[].description

string

Goal description.

Example

"Build coping skills for daily stressors."

goals[].progress_status

string

Current goal progress status.

Example

"None"

goals[].achievement_status

string

Current goal achievement status.

Example

"improving"

goals[].achievement_status_reason

string

Reason for the achievement status.

Example

"Uses paced breathing independently during stressful situations."

goals[].achievement_status_by

string

Name of the user who set the achievement status.

Example

"Morgan Ellis"

goals[].achievement_status_at

string

Formatted date and time when achievement status was set.

Example

"10-12-2026 11:45am"

goals[].lifecycle_status

string

Goal lifecycle status.

Example

"active"

goals[].is_active

boolean

Whether the goal is active.

Example

true

goals[].is_priority

boolean

Whether the goal is marked as a priority.

Example

true

goals[].priority

string

Goal priority.

Example

"Low"

goals[].patient_goal_statement

string

Goal statement supplied by the patient.

Example

"I want to feel calmer before bedtime."

goals[].baseline_description

string

Baseline description for measuring goal progress.

Example

"Reports anxiety interfering with sleep four nights weekly."

goals[].targeted_concerns

string

Parent treatment plan or health concern.

Example

"Behavioral Health Plan"

goals[].start_date

string

Formatted goal start date.

Example

"10-12-2026"

goals[].end_date

string

Formatted goal end date.

Example

"01-12-2027"

goals[].review_date

string

Formatted goal review date.

Example

"11-15-2026"

goals[].medical_codes

array

Medical codes associated with the goal.

goals[].medical_codes[].system

string

Coding system name.

Example

"Snomed"

goals[].medical_codes[].code

string

Code value in the specified coding system.

Example

"48694002"

goals[].statuses

array

Status codes associated with the goal.

goals[].statuses[].system

string

Coding system name.

Example

"Snomed"

goals[].statuses[].code

string

Code value in the specified coding system.

Example

"48694002"

goals[].modalities

array

Treatment modalities associated with the goal.

goals[].session_settings

array

Session settings associated with the goal.

goals[].target

object

Primary goal target measurement.

goals[].target.measurement_type_id

string

Athena measurement-type identifier.

Example

"9081"

goals[].target.end_date

string

Formatted target or milestone end date.

Example

"01-12-2027"

goals[].target.values

array

Measurement component values.

goals[].milestones

array

Goal milestone measurements.

goals[].milestones[].measurement_type_id

string

Athena measurement-type identifier.

Example

"9081"

goals[].milestones[].end_date

string

Formatted target or milestone end date.

Example

"01-12-2027"

goals[].milestones[].values

array

Measurement component values.

goals[].baseline_measurements

array

Baseline measurements for the goal.

goals[].baseline_measurements[].measurement_type_id

string

Athena measurement-type identifier.

Example

"9081"

goals[].baseline_measurements[].start_date

string

Formatted baseline measurement start date.

Example

"10-12-2026"

goals[].baseline_measurements[].values

array

Baseline measurement component values.

goals[].objectives

array

Objectives linked directly to this goal.

goals[].objectives[].objective_id

string

Athena TaskSchedule identifier for the objective.

Example

"909271"

goals[].objectives[].objective_name

string

Objective name.

Example

"Practice paced breathing daily"

goals[].objectives[].description

string

Objective description.

Example

"Practice for five minutes before bedtime."

goals[].objectives[].status

string

Objective status.

Example

"active"

goals[].objectives[].priority

string

Objective priority.

Example

"Medium"

goals[].objectives[].note

string

Objective note.

Example

"Review practice frequency at the next visit."

goals[].objectives[].start_date

string

Formatted objective start date.

Example

"10-12-2026"

goals[].objectives[].end_date

string

Formatted objective end date.

Example

"12-14-2026"

goals[].objectives[].added_by

string

Name of the user who added the objective.

Example

"Morgan Ellis"

goals[].objectives[].added_at

string

Formatted date and time when the objective was added.

Example

"10-09-2026 10:30am"

goals[].objectives[].last_action_by

string

Name of the user who last changed the objective.

Example

"Morgan Ellis"

goals[].objectives[].last_action_at

string

Formatted date and time of the last objective change.

Example

"10-12-2026 11:45am"

goals[].interventions

array

Interventions linked directly to this goal; independent of objectives.

goals[].interventions[].intervention_id

string

Athena ScheduledTask identifier for the intervention.

Example

"909272"

goals[].interventions[].intervention_name

string

Intervention name.

Example

"Teach paced breathing techniques"

goals[].interventions[].description

string

Intervention description.

Example

"Demonstrate breathing techniques and guide supervised practice."

goals[].interventions[].measurement_type

string

Intervention measurement type.

Example

"Duration"

goals[].interventions[].measurement_units

string

Units used to measure the intervention.

Example

"minutes"

goals[].interventions[].duration

integer

Configured intervention duration, when present.

goals[].interventions[].note

string

Intervention note.

Example

"Provide a written practice guide."

goals[].added_by

string

Name of the user who added the goal.

Example

"Morgan Ellis"

goals[].added_at

string

Formatted date and time when the goal was added.

Example

"10-09-2026 10:30am"

goals[].last_action_by

string

Name of the user who last changed the goal.

Example

"Morgan Ellis"

goals[].last_action_at

string

Formatted date and time of the last goal change.

Example

"10-12-2026 11:45am"

curl --request POST \
  --url https://preview.ontross.com/api/integrations/athena-prod/fetch-patient-treatment-plan \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"org_id":25910,"department_id":1,"patient_id":1},"auth_id":"auth_uuid_here"}'

Request BODY

{
  "input": {
    "org_id": 25910,
    "department_id": 1,
    "patient_id": 1
  },
  "auth_id": "auth_uuid_here"
}

Response BODY

{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "treatment_plan_summary": {
      "added_timestamp": "2026-10-09T14:30:00.000Z",
      "added_by": "Morgan Ellis",
      "review_due_date": "2026-11-15T05:00:00.000Z",
      "last_action_by": "Morgan Ellis",
      "last_action_timestamp": "2026-10-12T15:45:00.000Z"
    },
    "concerns_data": [
      {
        "id": "909107",
        "concern": "Anxiety",
        "is_active": true,
        "associated_diagnoses": "F41.1 Generalized anxiety disorder",
        "as_evidenced_by": "Reports persistent worry and difficulty falling asleep.",
        "goals": [
          "string"
        ],
        "goals_text": "Manage anxiety more effectively|Improve sleep habits",
        "added_by": "Morgan Ellis",
        "added_at": "10-09-2026 10:30am",
        "last_action_by": "Morgan Ellis",
        "last_action_at": "10-12-2026 11:45am",
        "list_menu": true
      }
    ],
    "client_characteristics": [
      {
        "ObservationId": "909284",
        "TypeName": "Strength",
        "Summary": "Participates in treatment planning",
        "Archived": false,
        "HealthConcerns": [
          {
            "HealthConcernId": "9064",
            "SnomedCode": "48694002"
          }
        ],
        "Created": "2026-10-09T14:30:00.000Z",
        "CreatedBy": {
          "Id": "90871",
          "FirstName": "Morgan",
          "LastName": "Ellis",
          "Suffix": "Jr."
        },
        "LastModified": "2026-10-12T15:45:00.000Z",
        "LastModifiedBy": {
          "Id": "90871",
          "FirstName": "Morgan",
          "LastName": "Ellis",
          "Suffix": "Jr."
        }
      }
    ],
    "goals": [
      {
        "goal_id": "9086",
        "goal_name": "Manage anxiety more effectively",
        "description": "Build coping skills for daily stressors.",
        "progress_status": "None",
        "achievement_status": "improving",
        "achievement_status_reason": "Uses paced breathing independently during stressful situations.",
        "achievement_status_by": "Morgan Ellis",
        "achievement_status_at": "10-12-2026 11:45am",
        "lifecycle_status": "active",
        "is_active": true,
        "is_priority": true,
        "priority": "Low",
        "patient_goal_statement": "I want to feel calmer before bedtime.",
        "baseline_description": "Reports anxiety interfering with sleep four nights weekly.",
        "targeted_concerns": "Behavioral Health Plan",
        "start_date": "10-12-2026",
        "end_date": "01-12-2027",
        "review_date": "11-15-2026",
        "medical_codes": [
          {
            "system": "Snomed",
            "code": "48694002"
          }
        ],
        "statuses": [
          {
            "system": "Snomed",
            "code": "48694002"
          }
        ],
        "modalities": [
          "string"
        ],
        "session_settings": [
          "string"
        ],
        "target": {
          "measurement_type_id": "9081",
          "end_date": "01-12-2027",
          "values": [
            "string"
          ]
        },
        "milestones": [
          {
            "measurement_type_id": "9081",
            "end_date": "01-12-2027",
            "values": [
              "string"
            ]
          }
        ],
        "baseline_measurements": [
          {
            "measurement_type_id": "9081",
            "start_date": "10-12-2026",
            "values": [
              "string"
            ]
          }
        ],
        "objectives": [
          {
            "objective_id": "909271",
            "objective_name": "Practice paced breathing daily",
            "description": "Practice for five minutes before bedtime.",
            "status": "active",
            "priority": "Medium",
            "note": "Review practice frequency at the next visit.",
            "start_date": "10-12-2026",
            "end_date": "12-14-2026",
            "added_by": "Morgan Ellis",
            "added_at": "10-09-2026 10:30am",
            "last_action_by": "Morgan Ellis",
            "last_action_at": "10-12-2026 11:45am"
          }
        ],
        "interventions": [
          {
            "intervention_id": "909272",
            "intervention_name": "Teach paced breathing techniques",
            "description": "Demonstrate breathing techniques and guide supervised practice.",
            "measurement_type": "Duration",
            "measurement_units": "minutes",
            "duration": 0,
            "note": "Provide a written practice guide."
          }
        ],
        "added_by": "Morgan Ellis",
        "added_at": "10-09-2026 10:30am",
        "last_action_by": "Morgan Ellis",
        "last_action_at": "10-12-2026 11:45am"
      }
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}