Healos External API

The Healos External API lets you programmatically manage patients, documents, and appointments, and pull clinical notes out of your Healos account.

Base URL

All API requests are made to:

https://api.healos.ai/ext-api/v1

curl -H "X-API-Key: hlsk_your_key_here" \
  https://api.healos.ai/ext-api/v1/patients

API keys, scopes, and security

Request limits and best practices

Error response format and status codes

Resource	Description
Patients	Create, read, update, and delete patient records
Documents	Upload, list, and delete patient documents (PDF, images, DOCX)
Appointments	Manage appointments with scheduling, recurrence, and status tracking
Clinical Notes	Read and bulk-export notes with transcript, medical codes, and patient context