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

# Prescription Tools

> Viewing prescription orders and fulfillment status

## Overview

Prescription tools let agents view the user's prescription orders and their fulfillment status.

## Fulfillment

US prescriptions — the ones you'll see — have `fulfillmentChannel: "PHOTON"`. Photon Health fulfills them and **texts the patient (SMS)** to choose a pharmacy and track the order. There is nothing to do in Arlo, so never offer pharmacy selection for these orders. This is also why `phone` is required on US profiles.

<Warning>
  Pharmacy search and selection are **not agent-facing MCP tools** — don't go hunting for one. US orders are managed entirely by Photon via SMS, and any pharmacy selection Arlo does itself happens in the consultation widget. The REST API exposes [`GET /api/pharmacies`](/api-reference/prescriptions/search-pharmacies) and [`POST /api/prescriptions/{id}/pharmacy`](/api-reference/prescriptions/select-pharmacy) for direct HTTP integrations only; a US order refuses selection with `MANAGED_EXTERNALLY`.
</Warning>

<Note>
  Legacy Canadian orders carry `fulfillmentChannel: "ARLO"` — the prescription is faxed to the pharmacy the patient chose in the widget.
</Note>

## get\_prescriptions

Get the user's prescription history — a list of prescription orders with medications, status, target pharmacy, and fulfillment channel.

### Parameters

None required.

### Returns

```json theme={null}
{
  "prescriptions": [
    {
      "prescriptionOrderId": "rx_abc123",
      "status": "SIGNED",
      "fulfillmentChannel": "PHOTON",
      "timestamp": "2026-06-15T14:30:00Z",
      "prescriptions": [
        {
          "prescriptionId": "prx_001",
          "drug": {
            "name": "Amoxicillin",
            "strength": "500mg",
            "form": "Capsule"
          },
          "quantity": 21,
          "instructions": "Take 1 capsule 3 times daily for 7 days",
          "hasRefill": false,
          "refillQuantity": 0
        }
      ],
      "targetPharmacy": null
    }
  ]
}
```

### Prescription Statuses

| Status      | Description                                         |
| ----------- | --------------------------------------------------- |
| `UNSIGNED`  | Prescription created but not yet signed by provider |
| `SIGNED`    | Signed by provider                                  |
| `SENT`      | Sent to the pharmacy (`ARLO` fax flow)              |
| `SUCCEEDED` | Successfully received by pharmacy                   |
| `FAILED`    | Failed to send to pharmacy                          |
| `CANCELED`  | Prescription was canceled                           |

***

## get\_prescription

Get details of a specific prescription order — all medications in the order, current status, target pharmacy (if selected), and fulfillment channel.

### Parameters

| Parameter             | Type   | Required | Description               |
| --------------------- | ------ | -------- | ------------------------- |
| `prescriptionOrderId` | string | Yes      | The prescription order ID |

### Returns

```json theme={null}
{
  "prescriptionOrderId": "rx_abc123",
  "status": "SIGNED",
  "fulfillmentChannel": "PHOTON",
  "timestamp": "2026-06-15T14:30:00Z",
  "provider": {
    "name": "Dr. Sarah Johnson, NP",
    "licenseNumber": "12345"
  },
  "prescriptions": [
    {
      "prescriptionId": "prx_001",
      "drug": {
        "name": "Amoxicillin",
        "strength": "500mg",
        "form": "Capsule"
      },
      "quantity": 21,
      "instructions": "Take 1 capsule 3 times daily for 7 days",
      "hasRefill": false,
      "refillQuantity": 0
    }
  ],
  "targetPharmacy": null
}
```

`targetPharmacy` stays `null` on `PHOTON` orders — the patient picks the pharmacy in Photon's SMS flow, not in Arlo. Legacy `ARLO` orders carry the chosen pharmacy's `companyName`, `address`, `city`, and `phone`.

### What to tell the user

* **`PHOTON` (US)**: "Photon Health will text you to pick a pharmacy and track your order." Don't offer to select a pharmacy in Arlo — attempts are refused with `MANAGED_EXTERNALLY`.
* **`ARLO` (legacy Canadian orders)**: pharmacy selection happens in the consultation widget; once selected, the pharmacy receives the prescription by fax and prepares the medication.