# Arlo Health

> Arlo Health API documentation. Healthcare infrastructure for AI agents: MCP server, REST API, and a free price transparency API.

- [Arlo Health Documentation](https://docs.arlohealth.ai/index.md): Integrate Arlo Health through MCP or REST for patient profiles, insurance records, conversations, care pricing, and care jobs.
- [Quickstart](https://docs.arlohealth.ai/quickstart.md): Connect to Arlo Health and follow a patient conversation
- [Connect to Claude Web](https://docs.arlohealth.ai/tutorials/claude-web.md): Connect Arlo Health as a Claude web connector
- [Connect to ChatGPT](https://docs.arlohealth.ai/tutorials/chatgpt-web.md): Connect Arlo Health as a ChatGPT web connector
- [Conversation Lifecycle](https://docs.arlohealth.ai/concepts/consultation-lifecycle.md): Conversation states, provider visits, and resumable waits
- [Authentication](https://docs.arlohealth.ai/concepts/authentication.md): Authenticate MCP clients with OAuth 2.1 and PKCE
- [Payments](https://docs.arlohealth.ai/concepts/payments.md): Patient approval and temporary holds for provider visits
- [MCP Tools Overview](https://docs.arlohealth.ai/mcp-tools/overview.md): Tool categories, host behavior, and common Arlo Health workflows
- [Authentication](https://docs.arlohealth.ai/mcp-tools/authentication.md): Authenticate MCP clients and inspect session status
- [Profile](https://docs.arlohealth.ai/mcp-tools/profile.md): Read patient profiles, capabilities, and update patient information
- [Conversations](https://docs.arlohealth.ai/mcp-tools/conversations.md): Start, list, inspect, and manage Arlo Health conversations
- [Messaging](https://docs.arlohealth.ai/mcp-tools/messaging.md): Send text and media, wait for replies, and read conversation attachments
- [Prescriptions](https://docs.arlohealth.ai/mcp-tools/prescriptions.md): Read prescription orders and fulfillment status
- [Health Records](https://docs.arlohealth.ai/mcp-tools/health-records.md): Connect insurance sources and read linked health records
- [Care Pricing](https://docs.arlohealth.ai/mcp-tools/pricing.md): Estimate care prices, check network status, and read provider evidence
- [Care Jobs](https://docs.arlohealth.ai/mcp-tools/care-jobs.md): Request care actions, answer the care team's questions, and track patient-approved execution
- [Webhook Tools](https://docs.arlohealth.ai/mcp-tools/webhooks.md): Register an endpoint for account and care activity notifications
- [REST API](https://docs.arlohealth.ai/api-reference/introduction.md): Traditional HTTP API for Arlo Health integration
- [Get MCP Server Card](https://docs.arlohealth.ai/api-reference/discovery/mcp-server-card.md): Returns the MCP Server Card for auto-discovery. Contains server capabilities, tool list, and authentication info.
- [OAuth Protected Resource](https://docs.arlohealth.ai/api-reference/discovery/oauth-protected-resource.md): RFC 9728 metadata pointing to the authorization server.
- [OAuth Authorization Server](https://docs.arlohealth.ai/api-reference/discovery/oauth-authorization-server.md): OAuth 2.1 authorization server metadata including endpoints and supported features.
- [List Conversations](https://docs.arlohealth.ai/api-reference/consultations/list.md): Returns the user's conversations, newest activity first.
- [Start Conversation](https://docs.arlohealth.ai/api-reference/consultations/start.md): Creates a new healthcare consultation and begins AI triage.
- [Get Conversation](https://docs.arlohealth.ai/api-reference/consultations/get.md): Returns the current status, messages, and payment gate info for a consultation.
- [Stop Provider Request](https://docs.arlohealth.ai/api-reference/consultations/cancel.md): Stops the conversation's current attempt to connect with a provider and returns it to AI-only chat (IDLE). This does NOT end the conversation — the thread stays open and can be re-engaged anytime by sending a message (which re-runs triage).
- [Send Message](https://docs.arlohealth.ai/api-reference/consultations/send-message.md): Sends one or more text messages in a consultation, written in the first person as the patient speaking.
- [Wait for Reply](https://docs.arlohealth.ai/api-reference/consultations/wait-for-reply.md): Blocks until the next reply lands in the conversation (an AI triage reply, a provider connecting, or a provider message) and returns it, instead of polling GET /api/consultations/{id}. The REST form of the wait_for_reply tool.
- [Get Clinical Notes](https://docs.arlohealth.ai/api-reference/consultations/get-notes.md): Returns the provider's clinical notes for each provider visit on this conversation. Notes exist only for visits a provider has closed out with a note — the conversation itself never closes. Check pastVisits[].hasNotes from GET /api/consultations/{id} first.
- [Upload Media](https://docs.arlohealth.ai/api-reference/consultations/upload-media.md): Attaches a photo or video to a consultation. Provide the bytes as base64 in `data`, or a publicly reachable HTTPS `url` Arlo downloads server-side, and the media is uploaded and sent for you. Provide neither and the response is a short-lived (~60s) presigned URL to PUT the file to yourself.
- [Get Media URL](https://docs.arlohealth.ai/api-reference/consultations/get-media.md): Returns a signed URL to view a photo, video, or file attachment from a message.
- [Get Profile](https://docs.arlohealth.ai/api-reference/profile/get.md): Returns the account, patients, tier, capabilities, connections and health-record counts.
- [Update Patient](https://docs.arlohealth.ai/api-reference/profile/update-patient.md): Update patient demographics, medical history, address, or terms acceptance. Supports partial updates - only include fields you want to change.
- [Get Payment Status](https://docs.arlohealth.ai/api-reference/payments/status.md): Returns the available pay-per-use option(s) and the per-visit price. Arlo is pay-per-use; there are no subscriptions and no payment state to check, since every visit is approved on a Stripe page at booking.
- [List Prescriptions](https://docs.arlohealth.ai/api-reference/prescriptions/list.md): Returns the user's prescription order history.
- [Get Prescription](https://docs.arlohealth.ai/api-reference/prescriptions/get.md): Returns details of a specific prescription order.
- [Get Health Records](https://docs.arlohealth.ai/api-reference/health-records/get.md): Read-only view over the patient's insurance and health records, sourced from their insurer via Flexpa. Call with no `section` first: `summary` returns the connection status, the coverage header, demographics, and a record COUNT per category. Then pass a `section` to drill in. Rows are newest-first a…
- [Start Records Connection](https://docs.arlohealth.ai/api-reference/health-records/start-link.md): Starts a records connection: the user signs in to their insurer, or verifies their identity for a nationwide TEFCA search when `ial2Mode` is true. Returns an `authorizationUrl` to hand to the user (valid 15 minutes, can be reopened), a `linkNonce` to poll with, and a `notice` to relay to the user in…
- [Poll Records Connection](https://docs.arlohealth.ai/api-reference/health-records/link-status.md): Outcome of a connection started with POST /api/health-records/link. Keep polling while `status` is `pending`. On `imported`, `syncing: true` means the clinical sync is still running, so GET /api/health-records may fill in shortly. On `cancelled`, `failed`, or `expired`, offer a fresh POST /api/healt…
- [Search Care Prices](https://docs.arlohealth.ai/api-reference/pricing/search.md): Nearby in-network care options with estimated negotiated prices under the user's plan, for about 170 common outpatient services. This is area discovery ("what does this cost around here"), not a clinic directory: for any NAMED clinic, brand, or provider call POST /api/pricing/network-status first, b…
- [Check Network Status](https://docs.arlohealth.ai/api-reference/pricing/network-status.md): Whether a specific provider or facility is in-network for the user's plan, and with `code`, what they charge for one service, from the insurer's published rate files. Call this FIRST for any named clinic, brand, facility, or provider. Pass the name plus city or ZIP; an NPI works too and is never req…
- [Get Provider Evidence](https://docs.arlohealth.ai/api-reference/pricing/provider-evidence.md): Public-data evidence about ONE specific provider by 10-digit NPI: Medicare-derived experience, facility outcome context (facility-level, never the clinician's own outcome), Medicare payment anchors, or an explained absence. Call it only once the conversation is about one provider; resolve the NPI fi…
- [Create Care Job](https://docs.arlohealth.ai/api-reference/care-jobs/create.md): Propose a real-world care action that Arlo's care team executes after the user approves: `move_referral` (an EXTERNAL referral written by an outside provider), `book_appointment`, `cancel_or_reschedule`, `send_records`, `dispute_claim`, or `resolve_billing_issue`. Returns `status: pending_approval`…
- [List Care Jobs](https://docs.arlohealth.ai/api-reference/care-jobs/list.md): The account's care jobs, those waiting on the user (needsInput) first, then newest first. Pending ones carry their approvalUrl.
- [Get Care Job](https://docs.arlohealth.ai/api-reference/care-jobs/get.md): Status plus the patient-visible audit trail. `status` moves from pending to approved, declined, or expired, then from approved to executed or failed once Arlo's care team completes the action. While the care team waits on the user it reads `needs_input` and carries `openItems` (answer with POST /api…
- [Answer the Care Team](https://docs.arlohealth.ai/api-reference/care-jobs/answer.md): Answer the care team's open questions on a job (`openItems` on GET /api/care-jobs/{id}). Ask the user every open item in one exchange and relay only what they say. Partial answers are stored as they arrive; the first answer to an item wins, and answering a closed item returns it under `alreadyClosed…
- [Wait on a Care Job](https://docs.arlohealth.ai/api-reference/care-jobs/wait.md): Resumable wait, like GET /api/consultations/{id}/reply. Returns the job (same shape as GET /api/care-jobs/{id}) the moment it changes, at once when it already needs the user or is finished, and with `stillWaiting: true` on timeout.
- [Get Webhook Status](https://docs.arlohealth.ai/api-reference/webhooks/get-status.md): Returns webhook configuration for the authenticated user. If sessionKey is provided, returns config for that specific session. Otherwise returns all sessions.
- [Register Webhook](https://docs.arlohealth.ai/api-reference/webhooks/register.md): Registers a webhook URL for receiving account notifications: conversation activity (triage replies, provider messages, status changes), prescription order updates, and care job updates (approved, declined, expired, each care-team step, executed, failed). Payloads carry a typed `event`, an optional `…
- [Pricing API](https://docs.arlohealth.ai/pricing/overview.md): Free, anonymous US cost estimates and network status from insurers' published rate files
- [Agent guide](https://docs.arlohealth.ai/pricing/guide.md): What to get from the person, how each route works, and how to read every field. Same text as GET /api/pricing.v1/guide.md
- [SKILL.md](https://docs.arlohealth.ai/pricing/skill.md): Drop-in skill for Grok Bot, Claude Code, and Codex. Same text as GET /api/pricing.v1/skill.md
- [API index: links to every route, limits, disclaimer](https://docs.arlohealth.ai/api-reference/discovery/api-index:-links-to-every-route-limits-disclaimer.md)
- [Supported services (CPT/HCPCS codes) with appliesTo and relatedCodes](https://docs.arlohealth.ai/api-reference/discovery/supported-services-cpthcpcs-codes-with-appliesto-and-relatedcodes.md)
- [Supported insurers and the names planHints.payerName accepts](https://docs.arlohealth.ai/api-reference/discovery/supported-insurers-and-the-names-planhintspayername-accepts.md)
- [Nearby in-network options with estimated negotiated prices for one service](https://docs.arlohealth.ai/api-reference/pricing/nearby-in-network-options-with-estimated-negotiated-prices-for-one-service.md): Area discovery: what does this service cost around here. NOT a clinic directory. The moment the patient names a specific clinic, brand, or provider, use network-status instead. Anonymous limit: 60 requests per minute per IP.
- [Same as POST with flat query parameters](https://docs.arlohealth.ai/api-reference/pricing/same-as-post-with-flat-query-parameters.md)
- [Is a named provider or facility in-network, and what do they charge for a service](https://docs.arlohealth.ai/api-reference/pricing/is-a-named-provider-or-facility-in-network-and-what-do-they-charge-for-a-service.md): Whether a specific provider or facility is in-network for the plan, and optionally what they charge for a service. Call this FIRST for any named clinic, brand, facility, or provider: the billing-entity fork (same visit, very different rates by contracting entity) only surfaces here. Anonymous limit:…
- [Same as POST with flat query parameters](https://docs.arlohealth.ai/api-reference/pricing/same-as-post-with-flat-query-parameters.md)
- [Public-data evidence about one provider (by NPI)](https://docs.arlohealth.ai/api-reference/pricing/public-data-evidence-about-one-provider-by-npi.md): Public-data evidence about ONE specific provider: Medicare-derived experience, facility outcome context (facility-level, never the clinician's own outcome), Medicare payment anchors, or an explained absence. Use only once the conversation is focused on one provider. Anonymous limit: 60 requests per…
- [Same as POST with query parameters](https://docs.arlohealth.ai/api-reference/pricing/same-as-post-with-query-parameters.md)

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)
- [pricing-openapi](/api-reference/pricing-openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.