Skip to main content
A Hi Doctor consultation is created when a submitted questionnaire is paid for or covered by a plan, and it then moves through review by an EU-licensed doctor. The Consultation endpoints read the patient’s consultations and their status, and upload, download or delete the photographs attached to one. Photo limits and file handling are in Uploads and downloads. Last reviewed: 2026-11-04

​
Prerequisites

  • A patient bearer token and X-Brand-Slug: hi-doctor.
  • Photos can only be added to the patient’s own consultations.

​
Operations

​
Boundaries and side effects

  • Photos are JPEG, PNG or WebP, up to 10 MiB, 10,000 px per side and 25 megapixels, with at most 10 per consultation. JSON instead of multipart returns 415.
  • Uploading and deleting accept an Idempotency-Key. Without one, uploading is not idempotent: list photos before retrying.
  • A photo download can return 410 (the file can no longer be recovered) or 503 (storage unavailable).
  • Every consultation is reviewed in full by an EU-licensed doctor, who decides on medical grounds only. Approval and prescribing are outside this API; see Safety.