Houses

This endpoint is not generally available for questions please contact sales .
To simplify the parameters and to support a broader variety of packages, this endpoint accepts both GET and POST requests.
GET https://quis.de/api/v1/vps/houses?api_key=<YOUR-API-KEY>&address=<YOUR-ADDRESS>&house_type=<HOUSE-TYPE>&living_space=<LIVING-SPACE>&land_area=<LAND-AREA>&building_year=<BUILDING-YEAR>&condition=<CONDITION>&furnishing=<FURNISHING> HTTP/2

The house endpoint provides a first valuation for a house with specific characteristics.

Parameters

Either the address or coordinate parameter is required. If both are provided, the address will be used.

parametertypedescription
api_keystringRequired Your API key, find more information in the authentication section
addressstringThe address will be used to find the building block.
For more precise results, use addresses in the following format: street house_number, postal_code city
coordinatestringThe coordinate will be used to find the building block.
Format: latitude,longitude
Example: 53.56132168856504,9.91211843516794
house_typestringRequired The type of the house.
Available values: one-family, two-family, semi-detached, row
living_spacefloatRequired The living space of the property.
land_areafloatRequired The land area of the property.
building_yearintegerRequired The building year of the property.
conditionstringRequired The condition of the property.
Available values: dilapidated, bad, moderate, good, very good
furnishingstringRequired The furnishing of the property.
Available values: very simple, simple, good, upscale, very upscale

Example

{
  "api_key": "YOUR API KEY",
  "address": "Gasstraße, Hamburg",
  "house_type": "one-family",
  "living_space": 150.52,
  "land_area": 350.25,
  "building_year": 1980,
  "condition": "good",
  "furnishing": "good"
}

This example configuration will need to generate an URL like:

GET https://quis.de/api/v1/vps/houses?api_key=<YOUR-API-KEY>&address=Gasstraße,Hamburg&house_type=one-family&living_space=150.52&land_area=350.52&building_year=1980&condition=good&furnishing=good HTTP/2

Response values

valuetypedescription
valuationfloatThe predicted value of the house

Example

The provided example has random values and incomplete series, showing the expected format.
GET https://quis.de/api/v1/vps/houses?api_key=<YOUR-API-KEY>&address=Gasstraße,Hamburg&house_type=one-family&living_space=150.52&land_area=350.52&building_year=1980&condition=good&furnishing=good HTTP/2
{
  "valuation": 123456.78,
  "meta": {
    "url": "https://quis.de/geo/53.56238135,9.91097785903008",
    "version": "1.10.1"
  }
}