Documentation

API reference and the embeddable pre-triage widget for healthcare clients.

Getting started

The platform is a B2B clinical decision-support tool for provider organisations. Staff run grounded assessments from the assessment console, search the verified encyclopedia from Encyclopedia, and you can embed the patient-facing pre-triage widget on your own website. Every assessment is grounded in cited sources; anything that cannot be traced to a source is withheld.

API reference

POST /api/diagnose

Runs the 3-model NIM quorum over grounded candidates. Accepts symptoms, optional vitals, history, and an optional image (data URL). Returns the consensus, per-model votes, verified citations, treatments & red-flags, any extracted visual findings, and a safety verdict.

curl -X POST /api/diagnose -H "Content-Type: application/json" -d '{
  "symptoms": ["fever", "productive cough", "pleuritic chest pain"],
  "vitalSigns": { "temp": 38.6, "rr": 24 },
  "ageBand": "40-50",
  "imageDataUrl": "data:image/png;base64,..."   // optional
}'

GET /api/conditions

Free-text encyclopedia lookup across 11,000+ verified entries by name, ICD-10 or symptom. Returns conditions with symptoms, treatments, citations and (where available) a reference image.

curl "/api/conditions?q=psoriasis&limit=20"

POST /api/pre-triage

Fast, patient-safe pre-triage used by the widget. Never diagnoses — it returns a disposition (urgent / book / self-care) with safety-netting.

curl -X POST /api/pre-triage -H "Content-Type: application/json" \
  -d '{ "text": "mild sore throat for two days" }'

Embeddable pre-triage widget

Drop the widget onto your own website to relieve front-desk pressure: patients get an immediate, safe next-step (self-care, book, or seek urgent care) before they ever reach your team. Paste this snippet where you want it to appear:

<iframe
  src="https://ai-medical-diagnosis-dusky.vercel.app/widget?clinic=Your%20Clinic&booking=https://yourclinic.com/book"
  style="width:380px;height:560px;border:1px solid #e2e8f0;border-radius:16px"
  title="Symptom pre-triage"
  loading="lazy"></iframe>

Configuration

  • clinic — your organisation's name, shown in the widget header.
  • booking — the URL your “Book an appointment” button links to (your existing booking system).

Behaviour & safety

  • Urgent — emergency red-flags (e.g. chest pain, breathing difficulty) prompt the patient to seek immediate care; the booking CTA is suppressed.
  • Book — symptoms that warrant assessment route the patient to your booking link, with notes to mention.
  • Self-care — clearly minor presentations get safe general guidance plus pharmacist signposting, with safety-netting on what to watch for.
  • The widget never gives a diagnosis or prescription advice, and always shows a disclaimer.

Production note: the widget is served with a permissive frame-ancestors policy for easy embedding in this MVP. For a production rollout we restrict it to your verified domains.