Skenarios support

Creating a group valuation via API

Owned by Former user (Deleted)
Jun 12, 2023
26 min read

To find out more about Skenariolabs APIs and authorization please visit

In this example, we will do a group valuation. In the API examples change yourPortfolioId to the actual numeric portfolio id and change yourTokenHere to your actual JWT token

  1. To create a group valuation request you need to send a POST request like so:

curl --location 'https://api.skenarios.com/api/v1/portfolio/yourPortfolioId/propertyGroupValuation' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer yourTokenHere' \ --data '{ "address":"Tekniikantie 2", "postalCode":"02150", "city":"Espoo", "buildYear":"1964", "buildingType":"apartment", "lifts":"2", "floors":"4", "units":"30", "netFloorArea":"1005", "unitModels":[ { "unitId":"FIEspoo02150Tekniikantie2-1", "unitUsageType":"RESIDENTIAL", "floor":1, "floorArea":42, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":2, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-2", "unitUsageType":"RESIDENTIAL", "floor":2, "floorArea":42, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":2, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-3", "unitUsageType":"RESIDENTIAL", "floor":3, "floorArea":42, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":2, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-4", "unitUsageType":"RESIDENTIAL", "floor":4, "floorArea":42, "identicalUnits":3, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":2, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-5", "unitUsageType":"RESIDENTIAL", "floor":1, "floorArea":25, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":1, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-6", "unitUsageType":"RESIDENTIAL", "floor":2, "floorArea":25, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":1, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-7", "unitUsageType":"RESIDENTIAL", "floor":3, "floorArea":25, "identicalUnits":4, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":1, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] }, { "unitId":"FIEspoo02150Tekniikantie2-8", "unitUsageType":"RESIDENTIAL", "floor":4, "floorArea":25, "identicalUnits":3, "properties":[ { "propertyId":"NUMBER_OF_ROOMS", "value":1, "parameterDomain":"PROPERTY_UNIT" }, { "propertyId":"CONDITION", "value":"GOOD", "parameterDomain":"PROPERTY_UNIT" } ] } ], "facadeMaterial":"brick", "heatingEnergyType":"district", "buildingIds":[ 103215918 ], "unitConditionMode":"GOOD", "properties":[ ], "saveResults":false, "groupTotalValue":null, "avgUnitAccuracy":null, "groupValuePerM2":null, "groupId":"FIEspoo02150Tekniikantie2", "buildingId":"" }'

Heating Types that the application accepts:

district
electric
gas
ground
oil
wood

A condition that the application accepts

NEW, EXCELLENT, GOOD, POOR, MEDIOCRE

A facade material

brick, concrete, timber

Building Types that the application takes:

single-family house
apartment
row house
vacation home

The response will include the valuation and accuracy for the group:

most important key/values are -

"groupTotalValue": 5552200.0, "avgUnitAccuracy": 0.0325, "groupValuePerM2": 5525.0,
{ "buildYear": 1964, "demolitionYear": null, "electricityId": null, "heatingId": null, "eValue": null, "coolingId": null, "buildingTypeId": null, "floors": 4, "floorArea": 1005, "volume": null, "balconies": null, "units": 30, "lifts": 2, "name": null, "address": "Tekniikantie 2", "postalCode": "02150", "city": "Espoo", "polygonUniqueId": "ud9wkgd9r_1", "country": null, "description": null, "nationalBuildingId": null, "energyClass": null, "province": null, "buildingBlockIdentifier": null, "lat": 60.180608799999995, "lon": 24.8218911, "analyticsLat": null, "analyticsLon": null, "grossInternalArea": null, "netInternalArea": null, "buildingId": "", "buildingName": null, "groupId": "FIEspoo02150Tekniikantie2", "groupName": null, "buildingType": "apartment", "heatingEnergyType": "district", "electricityEnergyType": null, "coolingEnergyType": null, "roofMaterial": null, "facadeMaterial": "brick", "useExistingIfAvailable": null, "addAssumedPastRenovations": true, "runRenovationsAsync": true, "analyticsMunicipality": null, "properties": [], "measures": [], "analytics": [], "majorRenovations": [], "countryCode": null, "cadastralId": null, "externalApplicationId": null, "lastPipeRenovation": null, "lastRoofRenovation": null, "lastFacadeRenovation": null, "netFloorArea": 1005, "unitConditionMode": "GOOD", "groupTotalValue": 5552200.0, "avgUnitAccuracy": 0.0325, "groupValuePerM2": 5525.0, "unitModels": [ { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-1", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 1, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 42.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 2, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-2", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 2, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 42.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 2, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-3", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 3, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 42.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 2, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-4", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 4, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 42.0, "externalApplicationId": null, "identicalUnits": 3, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 2, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-5", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 1, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 25.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 1, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-6", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 2, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 25.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 1, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-7", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 3, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 25.0, "externalApplicationId": null, "identicalUnits": 4, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 1, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null }, { "unitName": null, "unitId": "FIEspoo02150Tekniikantie2-8", "unitDescription": null, "unitUsageType": "RESIDENTIAL", "floor": 4, "monthlyRent": null, "capRate": null, "vacancyRate": null, "inflationRate": null, "rentGrowthRate": null, "opexPerMonth": null, "usedRent": null, "discountRate": null, "floorArea": 25.0, "externalApplicationId": null, "identicalUnits": 3, "analytics": null, "measures": null, "properties": [ { "propertyId": "NUMBER_OF_ROOMS", "value": 1, "parameterDomain": "PROPERTY_UNIT", "valueType": null }, { "propertyId": "CONDITION", "value": "GOOD", "parameterDomain": "PROPERTY_UNIT", "valueType": null } ], "renovations": null, "energyClass": null, "eValue": null } ], "buildingIds": [ 103215918 ], "saveResults": false, "lastSavedTimestamp": null, "modelVersion": "20230608-000000", "valuationDate": "2023-05-01" }

To save the group valuation you can now send the same request but set “saveResults” flag to true. This will save the building and units within the Skenariolabs application and add more calculations and assumptions such as energy class, energy consumption etc.

SkenarioLabs