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.