OMI

GET /api/report/appraisal/<report_uuid>/omi

Official Agenzia delle Entrate (OMI) quotations for the zone of the property, with the breakdown by typology and by maintenance condition.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/omi' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

Request Fields

Field	Required	Default	Description	Type	Example	Notes
`report_uuid`	yes		UUID of the report, given during the creation	string	`e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f`	Path parameter

JSON keys in the response:

Quotations of the property

sale_quotes: Sale quotation matching the property, in €/m². sale_quotes_min and sale_quotes_max give the range.
sale_quotes_var_mom / sale_quotes_var_yoy: Variation of the sale quotation against the previous period and against the same period of the previous year, in percentage. null when the comparison term is not available.
monthly_rent: Monthly rent quotation matching the property, in €/m² per month. monthly_rent_min and monthly_rent_max give the range.
monthly_rent_var_mom / monthly_rent_var_yoy: Variation of the rent quotation against the previous period and against the same period of the previous year, in percentage.

Zone

zone.area: Municipality of the OMI zone.
zone.address: Name of the OMI zone.
zone.reference_period: Reference period of the quotations, in Italian.
omi_zone: The same information as a list of id, name and value triples, ready to be rendered as a table. Switch on id (comune, zona_omi, tipologia, stato_conservativo, semestre) and display name and value.

Breakdowns

typology_quotes: Quotations of every property typology of the zone.
maintenance_states_quotes: Quotations of the matching typology, broken down by maintenance condition.

Both use the same shape:

type / type_id: Name and identifier of the typology or of the maintenance condition.
category: Macro category, such as Residenziale.
sale_value_min / sale_value_med / sale_value_max: Sale quotation range, in €/m².
monthly_rent_min / monthly_rent_med / monthly_rent_max: Rent quotation range, in €/m² per month.
yoy_sale / yoy_rent: Year on year variation of the sale and rent quotation, in percentage.

Charts

quotes_price_graph: Historical series of the sale quotation, as category and value pairs in €/m².
monthly_rent_graph: Historical series of the rent quotation, as category and value pairs in €/m² per month.

Period labels

category labels the OMI half year in a compact Italian form, 2°-24 meaning the second half of 2024. They are display strings: do not parse them, use zone.reference_period to state the period the report refers to.

Example Response

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "maintenance_states_quotes": [
      {
        "category": "Residenziale",
        "monthly_rent_max": 10.5,
        "monthly_rent_med": 9.0,
        "monthly_rent_min": 7.5,
        "sale_value_max": 1950,
        "sale_value_med": 1825,
        "sale_value_min": 1700,
        "type": "Normale",
        "type_id": 2,
        "yoy_rent": -10.0,
        "yoy_sale": -2.666666666666667
      }
    ],
    "monthly_rent": 9.0,
    "monthly_rent_graph": [
      {
        "category": "2°-24",
        "value": 9.0
      },
      {
        "category": "1°-25",
        "value": 9.0
      }
    ],
    "monthly_rent_max": 10.5,
    "monthly_rent_min": 7.5,
    "monthly_rent_var_mom": 0.0,
    "monthly_rent_var_yoy": null,
    "omi_zone": [
      {
        "id": "comune",
        "name": "Comune",
        "value": "PRATO"
      },
      {
        "id": "zona_omi",
        "name": "Zona",
        "value": "PRATO - Zona OMI D6"
      },
      {
        "id": "tipologia",
        "name": "Tipologia",
        "value": "Abitazioni civili"
      },
      {
        "id": "stato_conservativo",
        "name": "Stato Conservativo",
        "value": "Normale"
      },
      {
        "id": "semestre",
        "name": "Periodo",
        "value": "1° semestre 2025"
      }
    ],
    "quotes_price_graph": [
      {
        "category": "2°-24",
        "value": 1825.0
      },
      {
        "category": "1°-25",
        "value": 1825.0
      }
    ],
    "sale_quotes": 1825,
    "sale_quotes_max": 1950,
    "sale_quotes_min": 1700,
    "sale_quotes_var_mom": 0.0,
    "sale_quotes_var_yoy": null,
    "typology_quotes": [
      {
        "category": "Residenziale",
        "monthly_rent_max": 12.0,
        "monthly_rent_med": 10.0,
        "monthly_rent_min": 8.0,
        "sale_value_max": 2100,
        "sale_value_med": 1950,
        "sale_value_min": 1800,
        "type": "Ville e villini",
        "type_id": 1,
        "yoy_rent": 0.0,
        "yoy_sale": 0.0
      },
      {
        "category": "Residenziale",
        "monthly_rent_max": 10.5,
        "monthly_rent_med": 9.0,
        "monthly_rent_min": 7.5,
        "sale_value_max": 1950,
        "sale_value_med": 1825,
        "sale_value_min": 1700,
        "type": "Abitazioni civili",
        "type_id": 20,
        "yoy_rent": -10.0,
        "yoy_sale": -2.666666666666667
      }
    ],
    "zone": {
      "address": "PRATO - Zona OMI D6",
      "area": "PRATO",
      "reference_period": "1° semestre 2025"
    }
  }
}