# 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[​](#request "Direct link to Request") * application/json ### Body**required** * **note** objectrequired The Nabla-generated clinical note to normalize. ******sections** object\[]required Sections of the note. Array \[ * **key**copilot\_note\_section\_key (string)required A key identifying a section of a note. The set of possible keys depend on the template that is used. Check [Note template](/core-api/guides/note-templates-sections-legacy-2024-10-01) for possible values. **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`] **Example: **`CHIEF_COMPLAINT` **title**stringrequired The section title. **Example: **`Chief complaint` **text**string Content of the note section (required). **Example: **`Sleep disorder` ] **note\_locale**copilot\_note\_locale (string)required Locale of the note. **Possible values:** \[`en-US`, `en-GB`, `fr-FR`] **Example: **`en-US` ## Responses[​](#responses "Direct link to Responses") * 200 The normalized data extracted from the note. * application/json - Schema - Example (from schema) **Schema** * ******conditions**object\[]required FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note. Array \[ * **clinical\_status**fhir\_condition\_clinical\_status (string) The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `active` and `resolved` are supported for now. **Possible values:** \[`active`, `resolved`] **Example: **`active` ******coding**objectrequired ICD-10 coding representation of this condition. **system**stringrequired The used coding system, only ICD-10 is supported for now. **Possible values:** \[`http://hl7.org/fhir/sid/icd-10-cm`] **code**stringrequired Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry. **Example: **`G44.8` **display**stringrequired Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry. **Example: **`Other specified headache syndromes.` **categories**fhir\_condition\_category (string)\[] Categories of the condition. **Possible values:** \[`problem_list_item`, `encounter_diagnosis`] ] * ******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. Array \[ * ******conditions**object\[] Conditions of the family member of the patient. Array \[ * **clinical\_status**fhir\_condition\_clinical\_status (string) The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `active` and `resolved` are supported for now. **Possible values:** \[`active`, `resolved`] **Example: **`active` ******coding**objectrequired ICD-10 coding representation of this condition. **system**stringrequired The used coding system, only ICD-10 is supported for now. **Possible values:** \[`http://hl7.org/fhir/sid/icd-10-cm`] **code**stringrequired Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry. **Example: **`G44.8` **display**stringrequired Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry. **Example: **`Other specified headache syndromes.` **categories**fhir\_condition\_category (string)\[] Categories of the condition. **Possible values:** \[`problem_list_item`, `encounter_diagnosis`] ] * **relationship**family\_member\_conditions\_relationship (string) The relation to the patient of the family member the extracted conditions relate to, if applies. **Possible values:** \[`MOTHER`, `FATHER`, `BROTHER`, `SISTER`, `SON`, `DAUGHTER`, `GRANDMOTHER`, `GRANDFATHER`, `AUNT`, `UNCLE`, `OTHER`] ] * ******observations**object\[]required FHIR observations (including their LOINC code) extracted from the clinical note. Array \[ * ******coding**objectrequired LOINC coding representation of this observation. **system**stringrequired The used coding system, only LOINC is supported for now. **Possible values:** \[`http://loinc.org`] **code**stringrequired Code of the LOINC entry. **Example: **`29463-7` **display**stringrequired Description of the LOINC entry. **Example: **`Body weight` ******value\_quantity**object The value quantity for this observation, if not a range. **value**numberrequired The value of the quantity. **unit**string The unit 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`] **system**stringrequired The used coding system, only UCUM is supported for now. **Possible values:** \[`https://ucum.org`] **code**string The [UCUM](https://ucum.org/ucum.html) code of the unit. **Example: **`kg` ******value\_range**object The value range for this observation, if not a quantity. ******low**objectrequired The lower bound of the range. **value**numberrequired The value of the quantity. **unit**string The unit 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`] **system**stringrequired The used coding system, only UCUM is supported for now. **Possible values:** \[`https://ucum.org`] **code**string The [UCUM](https://ucum.org/ucum.html) code of the unit. **Example: **`kg` ******high**objectrequired **value**numberrequired The value of the quantity. **unit**string The unit 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`] **system**stringrequired The used coding system, only UCUM is supported for now. **Possible values:** \[`https://ucum.org`] **code**string The [UCUM](https://ucum.org/ucum.html) code of the unit. **Example: **`kg` **note**string Additional comment about the observation. **Example: **`Measured at rest.` ] ``` { "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." } ] } ``` ## Operation spec ```json { "method": "post", "path": "/generate_normalized_data", "operationId": "generate-normalized-data", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "description": "The Nabla-generated clinical note to normalize.", "type": "object", "properties": { "sections": { "type": "array", "description": "Sections of the note.", "items": { "type": "object", "description": "A note section.", "properties": { "key": { "type": "string", "description": "A key identifying a section of a note.\nThe set of possible keys depend on the template that is used. Check [Note template](/guides/note-templates-sections) for possible values.", "example": "CHIEF_COMPLAINT", "enum": [ "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" ], "title": "copilot_note_section_key" }, "title": { "type": "string", "description": "The section title.", "example": "Chief complaint" }, "text": { "type": "string", "description": "Content of the note section (required).", "example": "Sleep disorder" } }, "required": [ "key", "title" ], "title": "copilot_note_section_request" } } }, "required": [ "sections" ], "title": "copilot_note_request" }, "note_locale": { "type": "string", "description": "Locale of the note.", "enum": [ "en-US", "en-GB", "fr-FR" ], "example": "en-US", "title": "copilot_note_locale" } }, "required": [ "note", "note_locale" ], "title": "generate_normalized_data_request" } } } }, "responses": { "200": { "description": "The normalized data extracted from the note.", "content": { "application/json": { "schema": { "type": "object", "description": "Normalized data extracted from the note.", "properties": { "conditions": { "description": "FHIR conditions (including their ICD-10 code) corresponding to the patient's medical conditions as mentioned in the clinical note.", "type": "array", "items": { "type": "object", "description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).", "properties": { "clinical_status": { "type": "string", "enum": [ "active", "resolved" ], "description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `active` and `resolved` are supported for now.", "example": "active", "title": "fhir_condition_clinical_status" }, "coding": { "description": "ICD-10 coding representation of this condition.", "type": "object", "properties": { "system": { "type": "string", "description": "The used coding system, only ICD-10 is supported for now.", "enum": [ "http://hl7.org/fhir/sid/icd-10-cm" ] }, "code": { "type": "string", "example": "G44.8", "description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry." }, "display": { "type": "string", "example": "Other specified headache syndromes.", "description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry." } }, "required": [ "code", "display", "system" ], "title": "icd10_entry" }, "categories": { "description": "Categories of the condition.", "type": "array", "items": { "type": "string", "enum": [ "problem_list_item", "encounter_diagnosis" ], "description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).", "example": "problem_list_item", "title": "fhir_condition_category" } } }, "required": [ "coding" ], "title": "fhir_condition" } }, "family_history": { "description": "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.", "type": "array", "items": { "type": "object", "properties": { "conditions": { "description": "Conditions of the family member of the patient.", "type": "array", "items": { "type": "object", "description": "Structured [FHIR condition](https://www.hl7.org/fhir/condition.html).", "properties": { "clinical_status": { "type": "string", "enum": [ "active", "resolved" ], "description": "The [clinical status](https://www.hl7.org/fhir/condition-definitions.html#Condition.clinicalStatus) of the condition. Only `active` and `resolved` are supported for now.", "example": "active", "title": "fhir_condition_clinical_status" }, "coding": { "description": "ICD-10 coding representation of this condition.", "type": "object", "properties": { "system": { "type": "string", "description": "The used coding system, only ICD-10 is supported for now.", "enum": [ "http://hl7.org/fhir/sid/icd-10-cm" ] }, "code": { "type": "string", "example": "G44.8", "description": "Code of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry." }, "display": { "type": "string", "example": "Other specified headache syndromes.", "description": "Description of the [ICD-10](https://www.icd10data.com/ICD10CM/Codes) entry." } }, "required": [ "code", "display", "system" ], "title": "icd10_entry" }, "categories": { "description": "Categories of the condition.", "type": "array", "items": { "type": "string", "enum": [ "problem_list_item", "encounter_diagnosis" ], "description": "The category of a [FHIR condition](https://www.hl7.org/fhir/condition.html).", "example": "problem_list_item", "title": "fhir_condition_category" } } }, "required": [ "coding" ], "title": "fhir_condition" } }, "relationship": { "type": "string", "description": "The relation to the patient of the family member the extracted conditions relate to, if applies.", "enum": [ "MOTHER", "FATHER", "BROTHER", "SISTER", "SON", "DAUGHTER", "GRANDMOTHER", "GRANDFATHER", "AUNT", "UNCLE", "OTHER" ], "title": "family_member_conditions_relationship" } }, "title": "family_member_conditions" } }, "observations": { "description": "FHIR observations (including their LOINC code) extracted from the clinical note.", "type": "array", "items": { "type": "object", "description": "Structured [FHIR observation](https://www.hl7.org/fhir/observation.html).", "properties": { "coding": { "description": "LOINC coding representation of this observation.", "type": "object", "properties": { "system": { "type": "string", "description": "The used coding system, only LOINC is supported for now.", "enum": [ "http://loinc.org" ] }, "code": { "type": "string", "example": "29463-7", "description": "Code of the LOINC entry." }, "display": { "type": "string", "example": "Body weight", "description": "Description of the LOINC entry." } }, "required": [ "code", "display", "system" ], "title": "loinc_entry" }, "value_quantity": { "description": "The value quantity for this observation, if not a range.", "type": "object", "properties": { "value": { "type": "number", "description": "The value of the quantity." }, "unit": { "type": "string", "description": "The unit of the quantity.", "enum": [ "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" ] }, "system": { "type": "string", "description": "The used coding system, only UCUM is supported for now.", "enum": [ "https://ucum.org" ] }, "code": { "type": "string", "description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.", "example": "kg" } }, "required": [ "value", "system" ], "title": "observation_value_quantity" }, "value_range": { "description": "The value range for this observation, if not a quantity.", "type": "object", "properties": { "low": { "description": "The lower bound of the range.", "type": "object", "properties": { "value": { "type": "number", "description": "The value of the quantity." }, "unit": { "type": "string", "description": "The unit of the quantity.", "enum": [ "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" ] }, "system": { "type": "string", "description": "The used coding system, only UCUM is supported for now.", "enum": [ "https://ucum.org" ] }, "code": { "type": "string", "description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.", "example": "kg" } }, "required": [ "value", "system" ], "title": "observation_value_quantity" }, "high": { "description": "The higher bound of the range.", "type": "object", "properties": { "value": { "type": "number", "description": "The value of the quantity." }, "unit": { "type": "string", "description": "The unit of the quantity.", "enum": [ "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" ] }, "system": { "type": "string", "description": "The used coding system, only UCUM is supported for now.", "enum": [ "https://ucum.org" ] }, "code": { "type": "string", "description": "The [UCUM](https://ucum.org/ucum.html) code of the unit.", "example": "kg" } }, "required": [ "value", "system" ], "title": "observation_value_quantity" } }, "required": [ "low", "high" ], "title": "observation_value_range" }, "note": { "type": "string", "description": "Additional comment about the observation.", "example": "Measured at rest." } }, "required": [ "coding" ], "title": "observation_entry" } } }, "required": [ "conditions", "family_history", "observations" ], "title": "normalized_data" } } } } } } ```