Skip to content

valuations

robert-valueguard edited this page Nov 1, 2022 · 33 revisions

Make an valuation

The code below gives an example of how to use the client to make a valuations.

import valueguard

vgClient = valueguard.Client()
vgClient.authenticate("<username>", "<password>")


print(vgClient.valuation(search_criteria={
    "category":"apartment",
    "living_area_reference":"78",
    "wgs84lat":"59.864908174031974",
    "wgs84lon":"17.648463519218435"
}))

Field list

Field name Description Example
value Estimated value, in Swedish crowns 1342234
quality Quality of the valuation 2
time Time when the valuation was made 2021-01-15 15:11:54

Quality

The quality field is based on the differences between the object that we are making the valuation for and the comparison objects as well as differences between the comparison objects. Small differences give a high value in the quality field.

Name Description
1 Should not be used
2 Low quality
3 Okay
4 Good
5 High quality

Error code

Sometimes we are unable to give a valuation for an object. For example, sometimes there are no valid objects to base it on. In such cases, the value is -1 in both 'price' and 'quality'.

Required search criteria fields

Field name Description Example
category Category of residence apartment
living_area_reference Area of residence in sqm 78
wgs84lat Y-coordinate (latitude) from WGS84.
a global positioning system
59.864908174031974
wgs84lon X-coordinate (longitude) from WGS84.
a global positioning system
17.648463519218435

Category

Name
house
apartment

Optional search criteria fields

Field name Description Example
use_lmv_area True = data from lantmäteriet. False or unspecified = data from the real estate agent TRUE
floor_reference The floor of this particular residence 3
floors_reference The highest floor in the building residence 4
lot_size_reference Lot size 52
rooms_reference Number of rooms 4
side_area_reference Side or ancillary area 21
build_year_reference Year residence was built 1976
monthly_fee_reference Monthly fee 6000
standard_points_reference a number between 0-59 based on assessed value measuring the condition of the residence 30

Raw request

Get

curl https://api.valueguard.se/v1/valuation?access_token={access_token}&category={category}&living_area_reference={floor_area_reference}&wgs84lat={wgs84lat}&wgs84lon={wgs84lon}
Clone this wiki locally