# 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")

## Responses[​](#responses "Direct link to Responses")

* 200

The normalized data extracted from the note.

## 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": {
                "title": {
                  "type": "string",
                  "description": "Title of the note.",
                  "example": "Fever and strong headache"
                },
                "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](/2026-02-20/guides/note-templates/note-templates-sections) for possible values.",
                        "example": "CHIEF_COMPLAINT",
                        "enum": [
                          "ALLERGIES",
                          "APPOINTMENTS",
                          "ASSESSMENT",
                          "ASSESSMENT_AND_PLAN",
                          "CARDIOVASCULAR_RISK_FACTORS",
                          "CHIEF_COMPLAINT",
                          "CURRENT_MEDICATIONS",
                          "DIAGNOSTIC_TESTS_ORDERED",
                          "FOOD_HABITS",
                          "LIFESTYLE",
                          "PAST_MEDICAL_HISTORY",
                          "OBJECTIVES_AND_ADVICE",
                          "FAMILY_HISTORY",
                          "HISTORY_OF_PRESENT_ILLNESS",
                          "IMAGING_RESULTS",
                          "IMMUNIZATIONS",
                          "LAB_RESULTS",
                          "MENTAL_HEALTH_EXAM",
                          "MENTAL_HEALTH_HISTORY",
                          "PAST_OBSTETRIC_HISTORY",
                          "PAST_SURGICAL_HISTORY",
                          "PHYSICAL_EXAM",
                          "PLAN",
                          "PRESCRIPTION",
                          "HISTORY_OF_PRESENT_COMPLAINT",
                          "OBJECTIVE",
                          "SUBJECTIVE",
                          "SOCIAL_HISTORY",
                          "VITALS",
                          "WELL_CHILD_CARE"
                        ],
                        "title": "note_section_key"
                      },
                      "title": {
                        "type": "string",
                        "description": "The section title.",
                        "example": "Chief complaint"
                      },
                      "text": {
                        "type": "string",
                        "description": "Content of the note section.",
                        "example": "Sleep disorder"
                      }
                    },
                    "required": [
                      "key",
                      "title",
                      "text"
                    ],
                    "title": "note_section_request"
                  }
                },
                "locale": {
                  "type": "string",
                  "description": "Locale of the note.",
                  "enum": [
                    "ENGLISH_US",
                    "ENGLISH_UK",
                    "FRENCH_FR"
                  ],
                  "example": "ENGLISH_US",
                  "title": "note_locale"
                },
                "template": {
                  "type": "string",
                  "enum": [
                    "GENERIC_MULTIPLE_SECTIONS",
                    "GENERIC_MULTIPLE_SECTIONS_AP_MERGED",
                    "GENERIC_SOAP",
                    "GENERIC_SOAP_AP_MERGED",
                    "GENERIC_SOAP_PLUS_EXAM_TESTS_AP_MERGED",
                    "GENERIC_APSO_AP_MERGED",
                    "EMERGENCY_MULTIPLE_SECTIONS",
                    "EMERGENCY_SOAP",
                    "WCC_MULTIPLE_SECTIONS",
                    "WCC_SOAP",
                    "PSYCHIATRY_MULTIPLE_SECTIONS",
                    "PSYCHIATRY_SOAP",
                    "PSYCHOLOGY_MULTIPLE_SECTIONS",
                    "CARDIOLOGY_MULTIPLE_SECTIONS",
                    "DIET_MULTIPLE_SECTIONS"
                  ],
                  "description": "The template used to generate the note.\n\nSome templates are **only available in specific languages**. Check [Note template](/2026-02-20/guides/note-templates/note-templates-sections) for details.",
                  "example": "GENERIC_MULTIPLE_SECTIONS",
                  "title": "note_template"
                }
              },
              "required": [
                "sections",
                "locale",
                "template"
              ],
              "title": "note_request"
            },
            "include_corresponding_note_problems": {
              "description": "Whether to populate `corresponding_note_problem` on conditions extracted from the input note's `ASSESSMENT_AND_PLAN` section.",
              "type": "boolean",
              "default": false
            },
            "encounter_diagnoses_coding": {
              "type": "array",
              "description": "The ICD-10 coding for the patient's active encounter diagnoses. If some of them are found to apply to the current note, they will be prioritized in the normalization process.",
              "items": {
                "type": "object",
                "description": "An ICD-10 entry.",
                "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_request"
              }
            }
          },
          "required": [
            "note"
          ],
          "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."
                        },
                        "is_hcc": {
                          "description": "Indicates if this code maps to a Hierarchical Condition Category (HCC) under the version 28 risk adjustment model.",
                          "type": "boolean"
                        },
                        "is_mcc": {
                          "description": "Indicates if this code qualifies as a Major Complication or Comorbidity (MCC).",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "code",
                        "display",
                        "system",
                        "is_hcc",
                        "is_mcc"
                      ],
                      "title": "icd10_entry_with_hcc_mcc"
                    },
                    "alternative_coding": {
                      "type": "array",
                      "description": "An array of ICD-10 codes that are closely related to the primary coding and represent plausible alternative coding for the condition.",
                      "items": {
                        "type": "object",
                        "description": "An ICD-10 entry including HCC and MCC information.",
                        "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."
                          },
                          "is_hcc": {
                            "description": "Indicates if this code maps to a Hierarchical Condition Category (HCC) under the version 28 risk adjustment model.",
                            "type": "boolean"
                          },
                          "is_mcc": {
                            "description": "Indicates if this code qualifies as a Major Complication or Comorbidity (MCC).",
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "code",
                          "display",
                          "system",
                          "is_hcc",
                          "is_mcc"
                        ],
                        "title": "icd10_entry_with_hcc_mcc"
                      }
                    },
                    "categories": {
                      "description": "Categories of the condition. `PROBLEM_LIST_ITEM` refers to conditions that are resolved or may appear in past medical history, including chronic conditions that are not treated during the current encounter. `ENCOUNTER_DIAGNOSIS` refers to conditions treated during the current encounter. A condition can appear in both categories.",
                      "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"
                      }
                    },
                    "corresponding_note_problem": {
                      "description": "The title of the problem sub-header corresponding to this condition, in the \"Assessment & Plan\" section of the input note. This field is only filled when `include_corresponding_note_problems` is set to `true` in the request and that an `ASSESSMENT_AND_PLAN` section has been provided in the input note. If the condition was not extracted from the `ASSESSMENT_AND_PLAN` section, this field will be `null`.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "coding"
                  ],
                  "title": "fhir_patient_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_family_member_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 observation 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"
                          ],
                          "title": "observation_value_unit"
                        },
                        "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 observation 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"
                              ],
                              "title": "observation_value_unit"
                            },
                            "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 observation 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"
                              ],
                              "title": "observation_value_unit"
                            },
                            "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"
          }
        }
      }
    }
  }
}
```