Prescription Tools - Arlo Health

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.

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 and POST /api/prescriptions/{id}/pharmacy for direct HTTP integrations only; a US order refuses selection with MANAGED_EXTERNALLY.

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

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

{
  "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

{
  "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.

​Overview

​Fulfillment

​get_prescriptions

​Parameters

​Returns

​Prescription Statuses

​get_prescription

​Parameters

​Returns

​What to tell the user

Overview

Fulfillment

get_prescriptions

Parameters

Returns

Prescription Statuses

get_prescription

Parameters

Returns

What to tell the user