Energy

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

Energy block of the report: how the energy classes are distributed in the zone and what premium the efficient properties command, in price and in time on the market.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/energy' \
--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:

barchart_class_distribution: Distribution of the listings of the zone by energy class, from A4 to G, in percentage. Every entry carries the color to render the bar with.
barchart_average_price_class: Average unit price by energy efficiency band (Alta, Media, Bassa), in €/m².
barchart_time_on_market: Average time on the market by energy efficiency band, in months.
green_listings.percentage: Share of green listings, that is properties in the top energy classes, in percentage.
green_listings.chart: Breakdown of the green listings by class, as label, value and color.
premium_price: Price premium of the efficient properties: high and low are the unit prices of the two extreme bands in €/m², variation is the gap between them in percentage.
premium_times: Same comparison applied to the time on the market: high and low in months, variation in percentage.
header: Recap of the valued property for the page of the report.
zone.address: Zone the data refers to.
zone.reference_period: Reference period of the data, in Italian.

Efficiency bands

Alta, Media and Bassa group the energy classes into three bands. The same grouping is exposed by the Market block as pie_chart_energy_class, with the keys high_class, medium_class and low_class.

Colours are provided by the API

Charts carry the palette to render them, as CSS colours in color. Note that the values are not uniform: most are hex codes such as #39a845, while the G class returns the named colour red.

Example Response

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "barchart_average_price_class": [
      {
        "category": "Alta",
        "color": "#39a845",
        "value": 2938
      },
      {
        "category": "Media",
        "color": "#ffd551",
        "value": 2266
      },
      {
        "category": "Bassa",
        "color": "#eb3c27",
        "value": 2116
      }
    ],
    "barchart_class_distribution": [
      {
        "category": "A4",
        "color": "#336609",
        "value": 0
      },
      {
        "category": "A1",
        "color": "#19CD0F",
        "value": 9
      },
      {
        "category": "C",
        "color": "#FFFF13",
        "value": 9
      },
      {
        "category": "D",
        "color": "#FFC113",
        "value": 18
      },
      {
        "category": "G",
        "color": "red",
        "value": 37
      }
    ],
    "barchart_time_on_market": [
      {
        "category": "Alta",
        "color": "#39a845",
        "value": 4
      },
      {
        "category": "Media",
        "color": "#ffd551",
        "value": 7.6667
      },
      {
        "category": "Bassa",
        "color": "#eb3c27",
        "value": 4.4
      }
    ],
    "green_listings": {
      "chart": [
        {
          "color": "#5cc43d",
          "label": "A",
          "value": 9
        },
        {
          "color": "#42992b",
          "label": "B",
          "value": 9
        }
      ],
      "percentage": 9
    },
    "header": {
      "address": "Via Adolfo Sironi",
      "assetType": "Pentalocale",
      "city": "Prato",
      "surface": 90.0
    },
    "premium_price": {
      "high": 2938,
      "low": 2116,
      "variation": 39
    },
    "premium_times": {
      "high": 4,
      "low": 4,
      "variation": 0
    },
    "zone": {
      "address": "Iolo",
      "reference_period": "Dicembre - 2025"
    }
  }
}

header uses a different naming convention

In this block the recap key is assetType, in camel case, while every other block returns asset_type in snake case. Handle both when sharing the rendering code across pages.