YMed API v1

RESTful API for medical diagnosis assistance and clinical documentation. Get AI-powered differential diagnoses and extract structured medical data from doctor–patient conversations.

Quick Start

API Endpoints: /api/v1/diagnosis, /api/v1/medical-conversation, /api/v1/drugs

Authentication: Bearer token required (API key from Developers Portal)

Documentation: View Full Documentation →

Available Endpoints

POST /api/v1/diagnosis – Generate differential diagnosis from symptoms and clinical info
POST /api/v1/medical-conversation – Extract structured medical data (chief complaints, past history, medications, vital signs, etc.) from a conversation transcript
GET /api/v1/drugs – Retrieve structured drug monographs (generic name, brand names, dosing JSON, references, and clinical metadata)

Example: Diagnosis

curl -X POST http://localhost:3002/api/v1/diagnosis \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "symptoms": ["fever", "cough"],
    "patientAge": 35,
    "patientSex": "male"
  }'

Example: Medical Conversation

curl -X POST http://localhost:3002/api/v1/medical-conversation \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"conversation": "Doctor: What brings you in? Patient: Fever and cough for 3 days. Doctor: Any medications? Patient: Lisinopril for blood pressure."}'

Example: Drugs

curl -X GET "http://localhost:3002/api/v1/drugs?q=acetaminophen&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"