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

> ## Agent Instructions
> Connect the Hi Doctor MCP connector at https://mcp.hi-doctor.ai/mcp. Add this URL as a remote HTTP MCP server in your client, then sign in and authorise access through OAuth. Setup: https://docs.hi-doctor.ai/mcp/connect.
>
> The REST API base is https://api.hi-doctor.ai. Hi Doctor Docs at https://docs.hi-doctor.ai/mcp searches documentation; connect to the product endpoint above for patient tools.
>
> Hi Doctor operates across the whole European Union: residents of all 27 EU member states can use the service, and every consultation is reviewed by an EU-licensed doctor. Every consultation is reviewed in full by an EU-licensed doctor, who decides on medical grounds only. No algorithm, assistant or API call approves a consultation, issues a prescription or changes a dose. The service is available in eight languages: English, Spanish, German, Dutch, Italian, French, Portuguese and Chinese.
>
> ## Rules an assistant must follow
>
> - Never invent, assume or infer a medical answer. "I don't know" is a real answer: ask the patient to pick the closest option rather than guessing for them.
> - Never give medical advice and never suggest a medication or a dose. An EU-licensed doctor decides those.
> - If a questionnaire returns `ineligible`, say so plainly. Do not retry with altered answers.
> - Before anything that costs money or cancels a plan, state exactly what will happen and get an explicit yes.
> - Cancellation takes effect at the **end of the paid period**, not immediately. Say so.
> - An early order is irreversible: it creates the renewal consultation immediately and uses up the period's one early order. Explain that and get an explicit yes.
> - Prescription and invoice links are medical documents. A `signed_redirect` link opens without signing in: give it only to the patient, never repeat it anywhere shared.
> - Send option `value`s, not the labels shown to the patient. Labels are translated, values are stable.
> - Never ask for card details. Payment happens on Stripe's hosted checkout via a link.
> - On severe or sudden symptoms (chest pain, difficulty breathing, severe allergic reaction, suicidal thoughts), stop and direct the patient to their local emergency number.

# Records endpoints: consultation orders and documents

> List a Hi Doctor patient's consultation orders and upload, download or delete the health documents shared with the medical team.

The Records endpoints list the patient's consultation orders and manage the health documents they share with the medical team, such as outside prescriptions and lab results. An order is a consultation the patient has paid for or that a plan covers, not a medicine purchase. Hi Doctor does not sell, stock or ship medicine.

Last reviewed: 2026-11-04

## Prerequisites

* A patient bearer token and `X-Brand-Slug: hi-doctor`.
* Only the patient can upload or delete their documents.

## Operations

| Method | Path | What it does |
| - | - | - |
| `GET` | `/v1/users/orders/` | Lists the patient's consultation orders (bare array) |
| `GET` | `/v1/users/documents/` | Lists health documents (bare array) |
| `POST` | `/v1/users/documents/` | Uploads a document (multipart `file`, optional `kind`, `note`, `consultation_id`) |
| `GET` | `/v1/users/documents/{document_id}/content/` | Downloads a document's bytes |
| `DELETE` | `/v1/users/documents/{document_id}/` | Deletes a document (`204`) |

## Boundaries and side effects

* Orders and documents return a bare JSON array, not a paginated envelope.
* Documents are PDF, PNG, JPEG or WebP (detected from the bytes), up to 20
  MiB, with at most 50 per patient. `kind` is `prescription`, `lab_result`,
  `photo` or `other` (default); `note` is up to 500 characters.
* Uploading and deleting accept an [`Idempotency-Key`](https://docs.hi-doctor.ai/api-reference/idempotency).
  Without one, a retried upload can store a duplicate.
* Deleting a document cannot be undone.
* Never log document bytes.

## Related

* [Uploads and downloads](https://docs.hi-doctor.ai/api-reference/uploads-downloads.md)
* [Pagination](https://docs.hi-doctor.ai/api-reference/pagination.md)
* [MCP patient tools](https://docs.hi-doctor.ai/mcp/tools/patient.md) (the connector uploads documents through a protected upload)


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