{
  "version": "1.0",
  "modules": [
    {
      "name": "Measurement Units",
      "prefix": "/measurement-units",
      "endpoints": [
        {
          "method": "POST",
          "path": "/",
          "summary": "Create Measurement Unit",
          "description": "Creates a new measurement unit configuration with system type, available units, and defaults. Validates that system is metric or imperial and that all units are valid for their respective measurement types.",
          "request_body": {
            "schema_name": "MeasurementunitCreate",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": true
              }
            ]
          },
          "response": {
            "schema_name": "MeasurementunitResponse",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 201
        },
        {
          "method": "GET",
          "path": "/{measurementunit_id}",
          "summary": "Get Measurement Unit",
          "description": "Retrieves a single measurement unit configuration by ID. Returns 404 if the measurement unit does not exist.",
          "path_params": [
            {
              "name": "measurementunit_id",
              "type": "str"
            }
          ],
          "response": {
            "schema_name": "MeasurementunitResponse",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "GET",
          "path": "/",
          "summary": "List Measurement Units",
          "description": "Returns a paginated list of measurement unit configurations. Supports optional filtering by measurement system (metric or imperial).",
          "query_params": [
            {
              "name": "limit",
              "type": "int",
              "required": false,
              "default": 20
            },
            {
              "name": "offset",
              "type": "int",
              "required": false,
              "default": 0
            },
            {
              "name": "system",
              "type": "str",
              "required": false
            }
          ],
          "response": {
            "schema_name": "MeasurementunitResponse",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": true
          },
          "status_code": 200
        },
        {
          "method": "PUT",
          "path": "/{measurementunit_id}",
          "summary": "Update Measurement Unit",
          "description": "Updates an existing measurement unit configuration. Only provided fields are updated. Returns 404 if the measurement unit does not exist, 400 if no fields are provided.",
          "path_params": [
            {
              "name": "measurementunit_id",
              "type": "str"
            }
          ],
          "request_body": {
            "schema_name": "MeasurementunitUpdate",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": false,
                "nullable": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": false,
                "nullable": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": false,
                "nullable": true
              }
            ]
          },
          "response": {
            "schema_name": "MeasurementunitResponse",
            "fields": [
              {
                "name": "system",
                "type": "str",
                "required": true
              },
              {
                "name": "height_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "weight_units",
                "type": "List[str]",
                "required": true
              },
              {
                "name": "default_height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "default_weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "DELETE",
          "path": "/{measurementunit_id}",
          "summary": "Delete Measurement Unit",
          "description": "Deletes a measurement unit configuration by ID. Returns 404 if the measurement unit does not exist.",
          "path_params": [
            {
              "name": "measurementunit_id",
              "type": "str"
            }
          ],
          "status_code": 200
        }
      ]
    },
    {
      "name": "BMI Categories",
      "prefix": "/bmi-categories",
      "endpoints": [
        {
          "method": "POST",
          "path": "/",
          "summary": "Create BMI Category",
          "description": "Creates a new BMI category with name, BMI range, description, and color code. Returns 409 if a category with the same name already exists. Validates that max_bmi is greater than min_bmi.",
          "request_body": {
            "schema_name": "BmicategoryCreate",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false
              }
            ]
          },
          "response": {
            "schema_name": "BmicategoryResponse",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 201
        },
        {
          "method": "GET",
          "path": "/",
          "summary": "List BMI Categories",
          "description": "Returns a paginated list of all BMI categories ordered by minimum BMI value in ascending order. Supports standard limit and offset pagination parameters.",
          "query_params": [
            {
              "name": "limit",
              "type": "int",
              "required": false,
              "default": 20
            },
            {
              "name": "offset",
              "type": "int",
              "required": false,
              "default": 0
            }
          ],
          "response": {
            "schema_name": "BmicategoryResponse",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": true
          },
          "status_code": 200
        },
        {
          "method": "GET",
          "path": "/{category_id}",
          "summary": "Get BMI Category by ID",
          "description": "Retrieves a single BMI category by its unique identifier. Returns 404 if the category does not exist.",
          "path_params": [
            {
              "name": "category_id",
              "type": "str"
            }
          ],
          "response": {
            "schema_name": "BmicategoryResponse",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "PUT",
          "path": "/{category_id}",
          "summary": "Update BMI Category",
          "description": "Updates an existing BMI category. Only provided fields are updated; unset fields remain unchanged. Returns 404 if the category does not exist, 409 if the new name conflicts with another category.",
          "path_params": [
            {
              "name": "category_id",
              "type": "str"
            }
          ],
          "request_body": {
            "schema_name": "BmicategoryUpdate",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false,
                "nullable": true
              }
            ]
          },
          "response": {
            "schema_name": "BmicategoryResponse",
            "fields": [
              {
                "name": "name",
                "type": "str",
                "required": false
              },
              {
                "name": "min_bmi",
                "type": "float",
                "required": false
              },
              {
                "name": "max_bmi",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "description",
                "type": "str",
                "required": false
              },
              {
                "name": "color_code",
                "type": "str",
                "required": false
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "DELETE",
          "path": "/{category_id}",
          "summary": "Delete BMI Category",
          "description": "Deletes a BMI category by its unique identifier. Returns 404 if the category does not exist. Note that deleting a category may affect existing calculations that reference it.",
          "path_params": [
            {
              "name": "category_id",
              "type": "str"
            }
          ],
          "status_code": 204
        },
        {
          "method": "GET",
          "path": "/find-by-bmi/{bmi_value}",
          "summary": "Find Category for BMI Value",
          "description": "Finds and returns the appropriate BMI category for a given BMI value based on the category ranges. Returns null if no matching category is found. Returns 400 if the BMI value is negative.",
          "path_params": [
            {
              "name": "bmi_value",
              "type": "float"
            }
          ],
          "response": {
            "schema_name": "Optional[BmicategoryResponse]",
            "is_list": false,
            "fields": []
          },
          "status_code": 200
        }
      ]
    },
    {
      "name": "Calculations",
      "prefix": "/calculations",
      "endpoints": [
        {
          "method": "POST",
          "path": "/",
          "summary": "Create Calculation",
          "description": "Creates a new calculation record with height, weight, BMI value, and category. Validates that referenced measurement unit and BMI category exist if provided. Returns 404 if foreign key references are invalid.",
          "request_body": {
            "schema_name": "CalculationCreate",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              }
            ]
          },
          "response": {
            "schema_name": "CalculationResponse",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 201
        },
        {
          "method": "GET",
          "path": "/",
          "summary": "List Calculations",
          "description": "Returns a paginated list of calculation records ordered by timestamp in descending order. Does not include related measurement unit or BMI category details.",
          "query_params": [
            {
              "name": "limit",
              "type": "int",
              "required": false,
              "default": 20
            },
            {
              "name": "offset",
              "type": "int",
              "required": false,
              "default": 0
            }
          ],
          "response": {
            "schema_name": "CalculationResponse",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": true
          },
          "status_code": 200
        },
        {
          "method": "GET",
          "path": "/{calculation_id}",
          "summary": "Get Calculation",
          "description": "Retrieves a single calculation record by ID. Returns 404 if the calculation does not exist.",
          "path_params": [
            {
              "name": "calculation_id",
              "type": "str"
            }
          ],
          "response": {
            "schema_name": "CalculationResponse",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "PUT",
          "path": "/{calculation_id}",
          "summary": "Update Calculation",
          "description": "Updates an existing calculation record. Only provided fields are updated. Validates that referenced measurement unit and BMI category exist if provided. Returns 404 if the calculation or foreign key references are invalid.",
          "path_params": [
            {
              "name": "calculation_id",
              "type": "str"
            }
          ],
          "request_body": {
            "schema_name": "CalculationUpdate",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "weight",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false,
                "nullable": true
              },
              {
                "name": "category",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": false,
                "nullable": true
              }
            ]
          },
          "response": {
            "schema_name": "CalculationResponse",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "DELETE",
          "path": "/{calculation_id}",
          "summary": "Delete Calculation",
          "description": "Deletes a calculation record by ID. Returns 404 if the calculation does not exist.",
          "path_params": [
            {
              "name": "calculation_id",
              "type": "str"
            }
          ],
          "status_code": 204
        },
        {
          "method": "GET",
          "path": "/{calculation_id}/details",
          "summary": "Get Calculation Details",
          "description": "Retrieves a single calculation with full details including related measurement unit system information and BMI category details with description, color code, and range. Returns 404 if the calculation does not exist.",
          "path_params": [
            {
              "name": "calculation_id",
              "type": "str"
            }
          ],
          "response": {
            "schema_name": "CalculationDetailResponse",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": false
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "measurement_unit_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "bmi_category_id",
                "type": "str",
                "required": false,
                "nullable": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "created_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "updated_at",
                "type": "datetime",
                "required": true
              },
              {
                "name": "measurement_unit",
                "type": "MeasurementUnitSummary",
                "required": false,
                "nullable": true,
                "fields": [
                  {
                    "name": "id",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "system",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "default_height_unit",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "default_weight_unit",
                    "type": "str",
                    "required": true
                  }
                ]
              },
              {
                "name": "bmi_category",
                "type": "BmiCategorySummary",
                "required": false,
                "nullable": true,
                "fields": [
                  {
                    "name": "id",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "name",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "description",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "color_code",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "min_bmi",
                    "type": "float",
                    "required": true
                  },
                  {
                    "name": "max_bmi",
                    "type": "float",
                    "required": false,
                    "nullable": true
                  }
                ]
              }
            ],
            "is_list": false
          },
          "status_code": 200
        },
        {
          "method": "POST",
          "path": "/compute",
          "summary": "Compute BMI",
          "description": "Calculates BMI from height and weight inputs, validates ranges, converts to standard units, determines health category, stores the calculation, and returns the result with category information. Returns 400 if inputs are out of valid ranges.",
          "request_body": {
            "schema_name": "ComputeBMIRequest",
            "fields": [
              {
                "name": "height",
                "type": "float",
                "required": false
              },
              {
                "name": "weight",
                "type": "float",
                "required": false
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              }
            ]
          },
          "response": {
            "schema_name": "ComputeBMIResponse",
            "fields": [
              {
                "name": "bmi_value",
                "type": "float",
                "required": true
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "height",
                "type": "float",
                "required": true
              },
              {
                "name": "weight",
                "type": "float",
                "required": true
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_category",
                "type": "BmiCategorySummary",
                "required": false,
                "nullable": true,
                "fields": [
                  {
                    "name": "id",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "name",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "description",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "color_code",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "min_bmi",
                    "type": "float",
                    "required": true
                  },
                  {
                    "name": "max_bmi",
                    "type": "float",
                    "required": false,
                    "nullable": true
                  }
                ]
              }
            ],
            "is_list": false
          },
          "status_code": 201
        },
        {
          "method": "GET",
          "path": "/history/list",
          "summary": "Get Calculation History",
          "description": "Retrieves calculation history with measurement unit system and BMI category details, ordered by timestamp in reverse chronological order. Supports pagination.",
          "query_params": [
            {
              "name": "limit",
              "type": "int",
              "required": false,
              "default": 20
            },
            {
              "name": "offset",
              "type": "int",
              "required": false,
              "default": 0
            }
          ],
          "response": {
            "schema_name": "CalculationListItemResponse",
            "fields": [
              {
                "name": "id",
                "type": "str",
                "required": true
              },
              {
                "name": "height",
                "type": "float",
                "required": true
              },
              {
                "name": "weight",
                "type": "float",
                "required": true
              },
              {
                "name": "height_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "weight_unit",
                "type": "str",
                "required": true
              },
              {
                "name": "bmi_value",
                "type": "float",
                "required": true
              },
              {
                "name": "category",
                "type": "str",
                "required": true
              },
              {
                "name": "timestamp",
                "type": "datetime",
                "required": true
              },
              {
                "name": "measurement_unit",
                "type": "MeasurementUnitSummary",
                "required": false,
                "nullable": true,
                "fields": [
                  {
                    "name": "id",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "system",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "default_height_unit",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "default_weight_unit",
                    "type": "str",
                    "required": true
                  }
                ]
              },
              {
                "name": "bmi_category",
                "type": "BmiCategorySummary",
                "required": false,
                "nullable": true,
                "fields": [
                  {
                    "name": "id",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "name",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "description",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "color_code",
                    "type": "str",
                    "required": true
                  },
                  {
                    "name": "min_bmi",
                    "type": "float",
                    "required": true
                  },
                  {
                    "name": "max_bmi",
                    "type": "float",
                    "required": false,
                    "nullable": true
                  }
                ]
              }
            ],
            "is_list": true
          },
          "status_code": 200
        },
        {
          "method": "DELETE",
          "path": "/history/clear",
          "summary": "Clear Calculation History",
          "description": "Deletes all calculation records from the database. Returns the count of deleted records.",
          "status_code": 200
        }
      ]
    }
  ],
  "enums": {
    "MeasurementSystem": [
      "METRIC",
      "IMPERIAL"
    ],
    "HeightUnit": [
      "CM",
      "M",
      "FT",
      "IN"
    ],
    "WeightUnit": [
      "KG",
      "LBS"
    ]
  }
}