# Healos API

> Documentation for the Healos External API — manage patients, documents, and appointments.

## Docs

- [Create an appointment](https://docs.healos.ai/api-reference/appointments/create-an-appointment.md)
- [Delete an appointment](https://docs.healos.ai/api-reference/appointments/delete-an-appointment.md)
- [Get appointment by ID](https://docs.healos.ai/api-reference/appointments/get-appointment-by-id.md)
- [List appointments](https://docs.healos.ai/api-reference/appointments/list-appointments.md): Paginated list of appointments. Pass `external_id=<value>` to look up a single appointment by caller-supplied external_id (returns 404 if not found).
- [Update an appointment](https://docs.healos.ai/api-reference/appointments/update-an-appointment.md)
- [Delete a document](https://docs.healos.ai/api-reference/documents/delete-a-document.md): Delete a specific document for a patient.
- [List patient documents](https://docs.healos.ai/api-reference/documents/list-patient-documents.md): Retrieve documents for a specific patient. Pass `external_id=<value>` to look up a single document by caller-supplied external_id (returns 404 if not found).
- [Upload a document](https://docs.healos.ai/api-reference/documents/upload-a-document.md): Upload a document for a patient. Accepts PDF, JPEG, PNG, and DOCX files up to 10MB. Pass an optional `external_id` form field to attach a caller-supplied identifier (immutable once set; unique per organization).
- [Create a new patient](https://docs.healos.ai/api-reference/patients/create-a-new-patient.md)
- [Delete a patient](https://docs.healos.ai/api-reference/patients/delete-a-patient.md)
- [Get patient by ID](https://docs.healos.ai/api-reference/patients/get-patient-by-id.md)
- [List patients](https://docs.healos.ai/api-reference/patients/list-patients.md): Paginated list of patients. Pass `external_id=<value>` to look up a single patient by caller-supplied external_id (returns 404 if not found).
- [Update a patient](https://docs.healos.ai/api-reference/patients/update-a-patient.md)
- [Authentication](https://docs.healos.ai/authentication.md): How to authenticate with the Healos External API
- [Error Handling](https://docs.healos.ai/errors.md): API error response format and common status codes
- [Introduction](https://docs.healos.ai/introduction.md): Get started with the Healos External API
- [Making Requests](https://docs.healos.ai/making-requests.md): The proper way to call the Healos External API, end to end
- [Rate Limiting](https://docs.healos.ai/rate-limiting.md): API request limits and rate limiting behavior

## OpenAPI Specs

- [ext-api-v1](https://docs.healos.ai/openapi/ext-api-v1.json)
- [openapi](https://docs.healos.ai/api-reference/openapi.json)