> ## Documentation Index
> Fetch the complete documentation index at: https://agents.nanonets.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AthenaHealth Get Patient Chart Alert

> AthenaHealth patient chart-alert tool exposed through the Agents Platform.

This document covers `athenahealth_get_patient_chart_alert`, the AthenaHealth patient chart-alert tool exposed through the Agents Platform.

## Authentication

Uses the existing AthenaHealth connector credentials. The tool does not accept raw access tokens.

## `athenahealth_get_patient_chart_alert`

Fetches a patient's AthenaHealth chart alert and parses coding-relevant directives. This is read-only.

### Inputs

Required:

* `patient_id`: AthenaHealth patient ID.

Effectively required by AthenaHealth:

* `department_id`: the encounter's department ID. AthenaHealth's chart-alert endpoint requires a `departmentid` query parameter, so the call fails without it. Pass the `department_id` from `athenahealth_get_encounter_summary` / `athenahealth_get_encounter_details`.

### Parsed Directives

The tool returns raw alert text plus a parsed object with fields such as:

* `is_self_pay`
* `spravato_buy_bill_status`
* `required_provider_name`
* `eap_directive`
* `coding_directives`

The parser is intentionally conservative. It surfaces the raw text so downstream prompts can still inspect details that the deterministic parser did not classify.

### Output

```json theme={null}
{
  "success": true,
  "patient_id": "111",
  "raw_alert": "Self pay for Spravato...",
  "parsed": {
    "is_self_pay": true,
    "spravato_buy_bill_status": "buy_and_bill"
  }
}
```

Common failure reasons:

* `athenahealth_not_connected`
* AthenaHealth API error fetching chart alert

## Human-readable text

The tool emits markdown for the feed: a `## Chart Alert` summary table, a `## Parsed Directives` table (self-pay, Spravato Buy & Bill, required provider, EAP), and an `## Alert Text` block with the raw alert. The raw payload stays in `structuredContent`.

## Agent Instruction Guidance

Call this after `athenahealth_get_encounter_summary` passes cheap skip checks. Use it before fetching heavy documentation so self-pay / Buy-Bill / required-provider cases can short-circuit early.