Sahl AI Normalize API

Overview

The Normalize API generates standardized, FHIR-compliant data from a Sahl AI-generated clinical note. It extracts ICD-10 identifying key medical information such as medical history, family history, clinical assessments, and vital signs. This API is designed to enhance the integration of clinical notes into Electronic Health Records (EHRs) by aligning with FHIR protocols.

Endpoint

URL: https://sau-api.sahl.ai/note/normalize

Method: POST

Authentication

Include your bearer token in the Authorization header: Authorization: Bearer <YOUR_TOKEN>

Request Body

Content-Type: application/json

{
  "note": {
    "sections": [
      {
        "key": "CHIEF_COMPLAINT",
        "title": "Chief Complaint",
        "text": "Patient presents with persistent insomnia and daytime fatigue."
      },
      {
        "key": "HISTORY_OF_PRESENT_ILLNESS",
        "title": "History of Present Illness",
        "text": "Patient reports difficulty falling asleep and staying asleep for the past 3 months. Reports associated daytime fatigue and irritability."
      }
    ]
  }
}

Parameters

• note (object, required): The Sahl AI-generated clinical note to normalize.
  • sections (array of objects, required): Sections of the note.
    • key (string, required): Identifier for the section (e.g., "CHIEF_COMPLAINT", "HISTORY_OF_PRESENT_ILLNESS").
    • title (string, required): The section title.
    • text (string, required): Content of the note section.

Response

Success Response (200 OK)

Content-Type: application/json

[
  {
    "title": "Principal Diagnosis:",
    "body": ["- I21.9 - Acute myocardial infarction, unspecified"]
  },
  {
    "title": "Symptoms/Additional Diagnoses:",
    "body": [
      "- R06.0 - Dyspnoea",
      "- I10 - Essential (primary) hypertension",
      "- I51.7 - Cardiomegaly",
      "- I50.9 - Heart failure, unspecified"
    ]
  }
]

Error Response (400 Bad Request)

{
  "error": "Invalid request",
  "message": "Detailed error message"
}

Response Structure

• conditions (array of objects): FHIR conditions with ICD-10 codes representing the patient's medical conditions.
• family_history (array of objects): FHIR conditions representing family medical history, including relationship to the patient.
• observations (array of objects): FHIR observations with LOINC codes extracted from the clinical note.

Notes

• The API extracts and normalizes key medical information from the provided clinical note.
• All extracted data is structured according to FHIR standards for easy integration with EHR systems.
• The accuracy of normalized data depends on the quality and completeness of the input clinical note.

Example Usage

curl -X POST 'https://sau-api.sahl.ai/note/normalize' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
-d '{
  "note": {
    "sections": [
      {
        "key": "CHIEF_COMPLAINT",
        "title": "Chief Complaint",
        "text": "Patient presents with persistent insomnia and daytime fatigue."
      }
    ]
  }
}'

This API facilitates the extraction of standardized medical data from clinical notes, enhancing interoperability and data consistency across healthcare systems.