What is the Diagnostic Engine?
The Diagnostic Engine is an AI-powered service that replicates a doctor's clinical reasoning to conduct intelligent medical interviews. It dynamically generates follow-up questions based on patient responses, ensuring a thorough assessment of symptoms and risk factors.
By building a detailed clinical context, the engine delivers a comprehensive output that includes differential diagnoses, triage advice, and specialist recommendations—enabling applications to provide personalized and accurate medical guidance.
Use cases
Differential diagnoses
Get a list of medical conditions the patient may have
Self-management advice
Provides practical guidance to help patients manage their symptoms safely at home
Triage recommendation
Suggests the appropriate level of medical urgency based on the patient's symptoms
Specialist recommendation
Recommends the appropriate medical specialty to consult with based on the patient's symptoms
API types
Conversational API
Interactive diagnostic sessions with iterative questioning to reach a differential diagnoses list
Stateless API
Send all patient information in a single request and receive a question or a differential diagnoses list
Conversational API
Designed for interactive, real-time diagnostic sessions. It allows you to start a session with patient details, answer questions, and get diagnostic results.
Workflow
Integrating the Diagnostic Engine is straightforward — just three API calls to go from patient input to complete diagnostic results.
Step 1 — Start a session
Send patient details to start a session.
Receive a session_id and the first question.
Step 2 — Send answers
Send answers with the session_id and receive the next question.
Repeat until the API returns null for the question.
Step 3 — Get diagnosis
Provide a session ID to retrieve diagnostic results from existing patient data.
Diagnose or Get DDX endpoints at any time during the encounter to receive results sooner.
However, accuracy improves when the encounter is fully completed.Endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /ddx/v1/session | Create a session, initialize patient context, and receive the first question. |
| POST | /ddx/v1/session/{session_id}/next | Update an existing session by submitting answers and receiving the next step in the patient's assessment. |
| GET | /ddx/v1/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
Stateless API
Designed for non-interactive use cases where you send all patient information in a single request and receive a question or a complete diagnosis without iterative questioning.
Ask endpoint
Send patient details and findings to receive a question based on the patient's information. This gives the API user the power to control the flow of the conversation.
Diagnose endpoint
Send patient details and findings to receive a set of potential differential diagnoses.
Requirements
- Authentication: The API uses a bearer token for authentication.
API reference
Conversational API
Stateless API
How is this guide?