Skip to content

Valuation (AVM)

POST /avm

Calculate the valuation for a single property.

Example Request

curl -X POST 'https://appraisal-gr-sandbox.realitycs.it' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <token>' \
  --data-raw '{
    "Filters": {
        "latitude": 37.95140345595745,
        "longitude": 23.709728045430182,
        "contractTypeID": 1,
        "propertyTypeID": 101,
        "grossSquareFootage": 100,
        "maintenanceStatusID": 2,
        "buildYear": 1960,
        "unitFloor": 3,
        "rooms": 4,
        "energyClassID": 7,
        "bathrooms": 2,
        "elevator": true
    }
}'

Request Fields

Field Description Type Required Example Default
propertyTypeID Property type ID (see Taxonomies) integer yes 101
contractTypeID Contract type ID (see Taxonomies) integer yes 1
latitude Latitude number yes 37.9514034559
longitude Longitude number yes 23.7097280454
grossSquareFootage Floor area in square meters integer yes 100
maintenanceStatusID Condition (see Taxonomies) integer yes 2
buildYear Year of construction integer yes 1960
unitFloor Floor number integer optional 3 *
rooms Number of rooms integer optional 4 **
energyClassID Energy class (see Taxonomies) integer optional 7 13
bathrooms Number of bathrooms integer optional 2 ***
elevator Elevator available boolean optional true false

* unitFloor it's an enumeration starting from -1, 0 represents the ground floor
** default rooms value is 1 (it's an enumeration raging from 1 to 6, which means >5)
*** default bathrooms value is 1 if grossSquareFootage < 100, otherwise 2 (it's an enumeration raging from 1 to 4, which means >3)

Example Response

{
    "asking": {
        "price": 308000.0,
        "price_detail": {
            "price_max": 350000.0,
            "price_min": 265000.0,
            "price_mq": 3075
        }
    },
    "value": {
        "avm": 258000,
        "avm_detail": {
            "avm_max": 301000,
            "avm_min": 216000,
            "avm_mq": 2583
        },
        "gross_square_footage": 100
    },
    "uid": "4641a6a176e0406aa1f5ef221440e97c"
}