Skip to content

Property info

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

Attributes of the valued property, its ratings and the breakdown of the surfaces used for the valuation.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/property_info?show_geo=1' \
--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
show_geo optional false Adds lat and lng of the property to the response any ?show_geo=1 Any value enables it

JSON keys in the response:

  • lat / lng: Coordinates of the property. Only returned when show_geo is set.
  • property.address: Full address of the property.
  • property.zone: Zone and municipality the property belongs to.
  • property.property_type: Property typology.
  • property.surface_sqm: Commercial surface, in m².
  • property.rooms: Number of rooms.
  • property.bathrooms: Number of bathrooms.
  • property.floor: Floors the unit is on, as an array.
  • property.construction_year: Year of construction.
  • property.maintenance_status: Maintenance condition.
  • property.elevator: Whether the building has a lift.
  • property.description: Generated description of the property, in Italian. May be an empty string.
  • rating.quality_index: Overall quality score of the property, from 1 to 5.
  • rating.location: Score of the location, from 1 to 5.
  • rating.features: Score of the features of the unit, from 1 to 5.
  • rating.status: Score of the maintenance condition, from 1 to 5.
  • rating.profitability: Score of the expected profitability, from 1 to 5.
  • surface_analysis: Breakdown of the surfaces used for the valuation, as name and value pairs in m². It always ends with the total and the total commercial surface.

Example Response

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "lat": 43.865818409317896,
    "lng": 11.039137599752786,
    "property": {
      "address": "Via Adolfo Sironi, 56, Prato, PO",
      "bathrooms": 2,
      "construction_year": 2000,
      "description": "L'appartamento situato in Via Adolfo Sironi, 56, Prato, nella zona di Iolo, offre una soluzione abitativa confortevole e ben collegata. [...]",
      "elevator": false,
      "floor": [
        0.0
      ],
      "maintenance_status": "Buono / Abitabile",
      "property_type": "Appartamento",
      "rooms": 5,
      "surface_sqm": 90.0,
      "zone": "Iolo, Prato"
    },
    "rating": {
      "features": 1,
      "location": 4,
      "profitability": 5,
      "quality_index": 3,
      "status": 2
    },
    "surface_analysis": [
      {
        "name": "Abitazione",
        "value": 90.0
      },
      {
        "name": "Superficie totale",
        "value": 90.0
      },
      {
        "name": "Superficie totale commerciale",
        "value": 90.0
      }
    ]
  }
}