Risk Score AI - Public API Documentation

POST https://api.riskscoreai.com/api/v1/encounters/calculate-risk-score?apiKey=org_abc123...
Content-Type: application/json
{
  "physicianId": "6890742f1039c6d567a787ec",
  "encounterDate": "2025-08-25T14:30:00Z",
  "soapNotes": "SUBJECTIVE:\nChief Complaint: Severe headache and blurred vision\n\nHistory of Present Illness: \nPatient reports the onset of severe headache and blurred vision that started 3 days ago after prolonged screen exposure. The headache is described as throbbing, primarily frontal and temporal, with intensity of 8/10. Associated symptoms include photophobia and mild nausea. No fever, neck stiffness, or neurological deficits noted.\n\nPast Medical History: \n- Hypertension (diagnosed 2018, well-controlled on ACE inhibitors)\n- Migraine (episodic, usually triggered by stress and lack of sleep)\n- No history of head trauma or stroke\n\nCurrent Medications: \n- Lisinopril 10mg daily\n- Ibuprofen PRN for headaches\n\nAllergies: Penicillin (rash)\n\nSocial History: Works as software developer, spends 8-10 hours daily on computer\n\nOBJECTIVE:\nVital Signs:\n- Blood Pressure: 150/95 mmHg\n- Heart Rate: 88 bpm\n- Respiratory Rate: 16 breaths/min  \n- Temperature: 98.6°F (37°C)\n- Oxygen Saturation: 98% on room air\n- BMI: 24.5\n\nPhysical Examination:\nGeneral: Patient appears fatigued but alert and oriented x3. No acute distress.\nHEENT: Pupils equal, round, reactive to light. No papilledema on fundoscopic exam. No neck stiffness or lymphadenopathy.\nCardiovascular: Regular rate and rhythm, no murmurs, gallops, or rubs\nPulmonary: Clear to auscultation bilaterally\nNeurological: Cranial nerves II-XII intact. Motor strength 5/5 in all extremities. Deep tendon reflexes 2+ and symmetric. No focal neurological deficits.\n\nDiagnostic Results: \n- CT scan pending\n- Basic metabolic panel: Within normal limits\n- Complete blood count: WBC 7.2, Hgb 14.5, Plt 250\n\nASSESSMENT:\nPrimary Diagnosis: Migraine exacerbation, likely triggered by prolonged screen exposure and elevated blood pressure\n\nDifferential Diagnosis:\n1. Tension headache - possible but less likely given throbbing nature and photophobia\n2. Cluster headache - timing and characteristics not consistent  \n3. Hypertensive crisis - blood pressure elevated but not in crisis range\n4. Secondary headache due to intracranial pathology - low suspicion given normal neurological exam\n\nClinical Reasoning:\nPatient's presentation is most consistent with migraine exacerbation. The combination of throbbing headache, photophobia, and history of migraines supports this diagnosis. Elevated blood pressure may be contributing factor and requires monitoring. Normal neurological examination makes secondary causes less likely, but CT scan ordered to rule out structural abnormalities given severity of symptoms.\n\nPLAN:\nTreatment Plan:\n1. Prescribed sumatriptan 50mg, may repeat once in 2 hours if needed\n2. Encourage adequate hydration (8-10 glasses water daily)\n3. Rest in dark, quiet environment\n4. Apply cold compress to forehead\n5. Blood pressure management - consider medication adjustment if remains elevated\n\nPatient Instructions:\n- Take sumatriptan at onset of headache symptoms\n- Avoid bright screens and reduce computer usage\n- Implement 20-20-20 rule (every 20 minutes, look at something 20 feet away for 20 seconds)\n- Monitor blood pressure daily\n- Return to ED if headache worsens, develops fever, neck stiffness, or neurological symptoms\n\nFollow-up Plan:\n- Follow-up appointment with primary care physician in 1 week\n- Ophthalmology referral if vision problems persist\n- Consider neurology consultation if migraines become more frequent\n\nSafety Requirements: Patient advised not to drive until symptoms improve and vision clears completely."
}