Clinical Decision Support

POST /api/v1/ddxThis endpoint generates a list of differential diagnoses based on the provided summary from a consultation. The summary is the only required field. Optionally, the response can include explanations for each differential diagnosis and recommendations for treatment. The number of diagnoses returned can be customized, defaulting to 3 if not specified. Additional patient information can also be supplied if not covered in the summary . This endpoint assists in clinical decision-making by analyzing the consultation's summary and optionally providing detailed explanations and recommendations.HEADER PARAMETERS
REQUIREDX-Scrubs-HCI-Codestring
HCI code of the clinic making the API request.
REQUIREDX-Scrubs-HCI-Providerstring
Provider ID associated with your EHR application.
BODY PARAMETERS
REQUIREDsummarystring
A consultation summary. It does not need to follow the format of summaries from the summary endpoint but should resemble a SOAP note.
OPTIONALadditionalPatientInfostring
Allows additional patient information to be supplied if not covered in the SOAP note.
OPTIONALnumDdxnumber
Specifies how many differentials should be provided. Defaults to 3.
OPTIONALexplanationboolean
Determines whether an explanation for each differential should be included. Defaults to false.
OPTIONALrecommendationsboolean
Specifies if treatment recommendations should be included for each differential. Defaults to false.
Domain
BASE URL
1https://usescrubs.com
Sample Request
CURL
NodeJS
Python
Go
CURL
1curl --location 'https://usescrubs.com/api/v1/ddx' \
2--header 'X-Scrubs-HCI-Code: 00A123' \
3--header 'X-Scrubs-HCI-Provider: SAMPLE_EHR_1' \
4--header 'Content-Type: application/json' \
5--data '{
6    "summary": "Patient reports having a headache for the past week ...",
7    "additionalPatientInfo": "Patient previously diagnosed with Anxiety Disorder",
8    "numDdx": 2,
9    "explanation": true,
10    "recommendations": true
11}'
Sample Response
JSON
1{
2    "diagnosis": [
3        {
4            "diagnosis": "Tension Headache",
5            "explanation": "The patient's headache presentation, ...",
6            "recommendations": "Continue symptomatic management with ..."
7        }, 
8        {
9            "diagnosis": "Migraine Headache",
10            "explanation": "The patient's description of ...",
11            "recommendations": "Prescribe triptans for ..."
12        }, 
13    ]
14}
Contact us:hc@usescrubs.com