Skip to content

Types

Location#

Field Description Type Remarks
coordinates Coordinates
address Address

If used in a request, coordinates or address needs to be provided. If both are provided, coordinates takes precedence.

Coordinates#

Field Description Type Remarks
latitude Latitude float
longitude Longitude float

Address#

Field Description Type Remarks
postCode Post code string
city City string
street Street string
houseNumber House number string

Score#

Type Description Remarks
float Score value min: 0.0 (very bad)
max: 1.0 (very good)

PropertyLight#

Apartment and House properties#

Field Description Type Remarks
location Property location Location
propertyType Property type PropertyType
buildingYear The year the property was built integer min: 1850, max: \<current year> + 3
FR: min: 1700
livingArea Net living area, in m2 float min: 10, max: 800
CH min: 20, maximum two decimals
landArea Total area of the lot/parcel on which the house is standing, in m2 integer Only for house (required), min: 50, max: 5'000
BE min: 30
numberOfRooms Number of rooms float min: 1, max: 20
in CH and DE, half rooms are allowed (e.g. 2.5);

in JP, use the following rule to map SDK apartment configuration to numberOfRooms: numberOfRooms = Number of bedrooms + 1 (for all SDK combinations, except for 1R/1K where numberOfRooms = 1).
Not supported in BE
numberOfBedrooms Number of bedrooms integer min: 1, max: 20
Only supported in BE
numberOfBathrooms Number of bathrooms integer min: 1, max: 5
condition Condition of the property; considering an average across all relevant factors (bathroom, kitchen, floors, windows, heating, etc.) Condition

Multi-Family House properties#

Field Description Type Remarks
location Property location Location
propertyType Property type PropertyType
buildingYear The year the property was built integer min: 1800, max: \<current year> + 3
livingArea Net living area, in m2 float min: 10, max: 5'000, maximum two decimals
numberOfUnits Number of units in the building integer min: 3, max: 25
landArea Total area of the lot/parcel on which the property is standing, in m2 integer min: 0, max: 5'000
annualRentIncome Total yearly rent income integer min: 5'000, max: 1'000'000
condition Overall building condition Condition

Property#

Some of the fields have country-specific value ranges (see "Remarks" column below).

Apartment and House properties#

Field Description Type Remarks
location Property location Location
propertyType Property type PropertyType
buildingYear The year the property was built integer min: 1850, max: \<current year> + 3
FR min: 1700
livingArea Net living area, in m2 float min: 10, max: 800
CH min: 20, maximum two decimals
landArea Total area of the lot/parcel on which the house is standing, in m2 integer Required for house, min: 50, max: 5'000
BE min: 30
gardenArea Garden area, in m2 integer Only for apartments, min: 0, max: 200
volume Volume, in m3 integer Only for house, only relevant for CH, min: 250, max: 4'000
numberOfRooms Number of rooms float min: 1, max: 20
in CH and DE, half rooms are allowed (e.g. 2.5);

in JP, use the following rule to map SDK apartment configuration to numberOfRooms: numberOfRooms = Number of bedrooms + 1 (for all SDK combinations, except for 1R/1K where numberOfRooms = 1).
Not supported in BE
numberOfBedrooms Number of bedrooms integer min: 1, max: 20
Only supported in BE
numberOfBathrooms Number of bathrooms integer min: 1, max: 5
balconyArea Balcony / Terrace area, in m2 integer min: 0, max: 200
numberOfIndoorParkingSpaces Garage spaces integer min: 0, max: 6
numberOfOutdoorParkingSpaces Parking spaces integer min: 0, max: 6
floorNumber Floor number integer Only for apartments, min: 0, max: 20
FR, NL & BE: max: 50
JP: min: 1, max: 60
hasLift Lift availability boolean Only for apartments
energyLabel Energy label enum Either minergie or do not provide the field, only relevant for CH
hasSauna Sauna availability boolean Only for house
hasPool Pool availability boolean Only for house
numberOfFloorsInBuilding For apartments: Total number of floors of the building in which the apartment is located (Includes ground floor for all countries except FR).
For house: total number of floors of the house
integer
min: 1, max: 20
FR & NL: max: 50
JP: max: 60
isFurnished Whether the property is furnished or not boolean Only relevant for FR
isNew Whether the property has never been used before ("B√Ętiment neuf" in French, "Erstverkauf" / "Erstvermietung" in German) boolean Only relevant for FR, DE, AT & NL
renovationYear Last renovation year of the property integer Only relevant for CH and DE
min: 1950, max: <current year> + 3
condition.bathrooms Bathrooms condition Condition
condition.kitchen Kitchen condition Condition
condition.flooring Flooring condition Condition
condition.windows Windows condition Condition
condition.masonry Masonry condition Condition Only for house
quality.bathrooms Bathrooms quality Quality
quality.kitchen Kitchen quality Quality
quality.flooring Flooring quality Quality
quality.windows Windows quality Quality
quality.masonry Masonry quality Quality Only for house

Multi-Family House properties#

Field Description Type Remarks
location Property location Location
propertyType Property type PropertyType
buildingYear The year the property was built integer min: 1800, max: \<current year> + 3
livingArea Net living area, in m2 float min: 10, max: 5'000, maximum two decimals
numberOfUnits Number of units in the building integer min: 3, max: 25
landArea Total area of the lot/parcel on which the property is standing, in m2 integer min: 0, max: 5'000
annualRentIncome Total yearly rent income integer min: 5'000, max: 1'000'000 (Only relevant for DE)
condition.overall Overall building condition Condition (Only relevant for DE)
quality.overall Overall building quality Quality (Only relevant for DE)

PropertyType#

Field Description Type Remarks
code Property type enum apartment, house or multi_family_house (Only relevant for CH & DE)
subcode Property subtype enum Not relevant for FR, AT, JP and multi_family_house
apartment_normal, apartment_maisonette, apartment_attic, apartment_penthouse, apartment_terraced, apartment_studio, house_detached, house_semi_detached, house_row_corner, house_row_middle orhouse_farm

ValueRange#

Field Description Type Remarks
lower Lower bound value integer
upper Upper bound value integer

Confidence#

poor, medium or good

Condition#

renovation_needed, well_maintained or new_or_recently_renovated

Quality#

simple, normal, high_quality or luxury

Dossier Image#

Field Description Type Remarks
filename Filename of the uploaded image string Get the filename from the Dossier Images endpoint
caption Caption of the image string Maximum of 60 characters