Generate normalized data from a note
POST/generate-normalized-data
Generate normalized data from a Nabla-generated clinical note by extracting ICD-10 and LOINC codes in a FHIR-compliant structure.
It adeptly identifies and categorizes key medical information within the notes, such as past medical history, family medical history, clinical assessments, and vital signs.
Each piece of medical information is represented as an array of FHIR's conditions/observations, each including relevant ICD-10 codes, thereby ensuring compatibility with standardized medical data frameworks.
The Normalize functionality is tailored to enhance the integration of clinical notes into Electronic Health Records (EHRs), facilitating accurate and efficient documentation by aligning with FHIR protocols.
Request
- application/json
Body
required
- Array [
- ]
note objectrequired
The Nabla-generated clinical note to normalize.
sections object[]required
Sections of the note.
Possible values: [ALLERGIES
, APPOINTMENTS
, ASSESSMENT
, ASSESSMENT_AND_PLAN
, CARDIOVASCULAR_RISKS
, CHIEF_COMPLAINT
, CURRENT_MEDICATIONS
, DIET_APPOINTMENTS
, DIET_CHIEF_COMPLAINT
, DIET_HABITS
, DIET_LIFESTYLE
, DIET_MEDICAL_HISTORY
, DIET_OBJECTIVES
, DIET_VITALS
, FAMILY_HISTORY
, HISTORY_OF_PRESENT_ILLNESS
, IMAGING_RESULTS
, IMMUNIZATIONS
, LAB_RESULTS
, MENTAL_HEALTH_EXAM
, MENTAL_HEALTH_HISTORY
, PAST_MEDICAL_HISTORY
, PAST_OBSTETRIC_HISTORY
, PAST_SURGICAL_HISTORY
, PHYSICAL_EXAM
, PLAN
, PRESCRIPTION
, PSYCHOLOGY_HISTORY_OF_COMPLAINT
, SOAP_ASSESSMENT
, SOAP_OBJECTIVE
, SOAP_PLAN
, SOAP_SUBJECTIVE
, SOCIAL_HISTORY
, VITALS
, WELL_CHILD_CARE
]
A key identifying a section of a note. The set of possible keys depend on the template that is used. Check Note template for possible values.
The section title.
Content of the note section (required).
Possible values: [ENGLISH_US
, ENGLISH_UK
, FRENCH_FR
]
Locale of the note.
Responses
- 200
The normalized data extracted from the note.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- Array [
- ]
- ]
- Array [
- ]
conditions object[]required
FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.
Possible values: [active
, resolved
]
The clinical status of the condition. Only active
and resolved
are supported for now.
Possible values: [problem_list_item
, encounter_diagnosis
]
Categories of the condition.
family_history object[]required
FHIR conditions (including their ICD-10 code) representing family medical history details extracted from the clinical note. Each element includes the relationship to the patient and the list of related conditions.
conditions object[]
Conditions of the family member of the patient.
Possible values: [active
, resolved
]
The clinical status of the condition. Only active
and resolved
are supported for now.
Possible values: [problem_list_item
, encounter_diagnosis
]
Categories of the condition.
Possible values: [MOTHER
, FATHER
, BROTHER
, SISTER
, SON
, DAUGHTER
, GRANDMOTHER
, GRANDFATHER
, AUNT
, UNCLE
, OTHER
]
The relation to the patient of the family member the extracted conditions relate to, if applies.
observations object[]required
FHIR observations (including their LOINC code) extracted from the clinical note.
coding objectrequired
LOINC coding representation of this observation.
Possible values: [http://loinc.org
]
The used coding system, only LOINC is supported for now.
Code of the LOINC entry.
Description of the LOINC entry.
value_quantity object
The value quantity for this observation, if not a range.
The value of the quantity.
Possible values: [METER
, CENTIMETER
, FOOT
, KILOGRAM
, POUND
, MILLIMETERS_OF_MERCURY
, CENTIMETERS_OF_MERCURY
, CELSIUS
, FAHRENHEIT
, BEATS_PER_MINUTE
, BREATHS_PER_MINUTE
, LITER_PER_MINUTE
, MILLIMETER
, PERCENT
, INCH
]
The unit of the quantity.
Possible values: [https://ucum.org
]
The used coding system, only UCUM is supported for now.
The UCUM code of the unit.
value_range object
The value range for this observation, if not a quantity.
low objectrequired
The lower bound of the range.
The value of the quantity.
Possible values: [METER
, CENTIMETER
, FOOT
, KILOGRAM
, POUND
, MILLIMETERS_OF_MERCURY
, CENTIMETERS_OF_MERCURY
, CELSIUS
, FAHRENHEIT
, BEATS_PER_MINUTE
, BREATHS_PER_MINUTE
, LITER_PER_MINUTE
, MILLIMETER
, PERCENT
, INCH
]
The unit of the quantity.
Possible values: [https://ucum.org
]
The used coding system, only UCUM is supported for now.
The UCUM code of the unit.
high objectrequired
The higher bound of the range.
The value of the quantity.
Possible values: [METER
, CENTIMETER
, FOOT
, KILOGRAM
, POUND
, MILLIMETERS_OF_MERCURY
, CENTIMETERS_OF_MERCURY
, CELSIUS
, FAHRENHEIT
, BEATS_PER_MINUTE
, BREATHS_PER_MINUTE
, LITER_PER_MINUTE
, MILLIMETER
, PERCENT
, INCH
]
The unit of the quantity.
Possible values: [https://ucum.org
]
The used coding system, only UCUM is supported for now.
The UCUM code of the unit.
Additional comment about the observation.
{
"conditions": [
{
"clinical_status": "active",
"coding": {
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "G44.8",
"display": "Other specified headache syndromes."
},
"categories": [
"problem_list_item"
]
}
],
"family_history": [
{
"conditions": [
{
"clinical_status": "active",
"coding": {
"system": "http://hl7.org/fhir/sid/icd-10-cm",
"code": "G44.8",
"display": "Other specified headache syndromes."
},
"categories": [
"problem_list_item"
]
}
],
"relationship": "MOTHER"
}
],
"observations": [
{
"coding": {
"system": "http://loinc.org",
"code": "29463-7",
"display": "Body weight"
},
"value_quantity": {
"value": 0,
"unit": "METER",
"system": "https://ucum.org",
"code": "kg"
},
"value_range": {
"low": {
"value": 0,
"unit": "METER",
"system": "https://ucum.org",
"code": "kg"
},
"high": {
"value": 0,
"unit": "METER",
"system": "https://ucum.org",
"code": "kg"
}
},
"note": "Measured at rest."
}
]
}