What is the Diagnosis API?
The Diagnosis API is a backend service that powers intelligent medical question‑and‑answer and diagnostic workflows. It’s built around a clinical AI model that can conduct structured medical interviews through iterative questioning, adapt each next question based on previous answers, and build a detailed picture of the patient’s condition — ultimately providing a differential diagnosis along with related care recommendations.
Use cases
Differential diagnosis
Get a list of medical conditions the patient is suffering from
Self-management advice
Provides practical guidance to help individuals manage their symptoms safely at home
Triage recommendation
Suggests the appropriate level of care based on patient input.
Specialist recommendation
Recommends the appropriate medical specialty to visit based on patient input.
Workflow
Integrating the Diagnosis API is straightforward — just three API calls to go from patient input to complete diagnostic results.
Step 1 — Create a session
Send patient details to start a session.
Receive a session_id and the first question.
Step 2 — Update the session
Send answers with the session_id.
Repeat until the API returns null for the question.
Step 3 — Get diagnosis
Provide a session ID to retrieve diagnosis from existing patient data.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /ddx/session | Create a session, initialize patient context, and receive the first question. |
| POST | /ddx/session/{session_id} | Update an existing session by submitting answers and receiving the next step in the patient's assessment. |
| GET | /ddx/session/{session_id}/diagnose | Generate final outputs including differential diagnosis, triage, specialist, and self-management advice. |
For complete specifications and live testing, visit the API reference.
Architecture
Requirements
- Authentication: The API uses a bearer token for authentication.
API reference
How is this guide?