Properties light

This endpoint is not generally available. For questions please contact sales.

POST /valuations/properties_light HTTP/2

The property light endpoint returns a fast valuation for a property with specific characteristics. It only returns responses for addresses we could geocode with high confidence. Alternatively you can provide the coordinates yourself.

Example use-cases:

• Give a user a first valuation of their property in seconds
• Generate leads by letting a user value their property

Request

curl -X POST 'https://quis.de/api/v2/valuations/properties_light?api_key=<YOUR-API-KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "dealType": "sale",
    "property": {
      "propertyType": {
        "type": "house",
        "subtype": "house_one_family"
      },
      "location": {
        "address": {
          "street": "Gasstraße",
          "houseNumber": "10",
          "postCode": "22761",
          "city": "Hamburg"
        }
      },
      "livingArea": 500.25,
      "landArea": 1200.5,
      "buildingYear": 1900,
      "condition": "good",
      "quality": "good"
    }
  }'

Field	Description	Type	Remarks
dealType	Deal type of the property	enum	sale, rent
propertyId	Id of a property	string	If a propertyId is provided, the property object is ignored and not required.
property	Charasteristics of the property	PropertyLight

PropertyLight

Some fields are marked as required for different property types. However, those could also be passed for other property types to improve the valuation.

Field	Description	Type	Remarks
propertyType	Type of the property	PropertyType	"type": "plot" is not supported
location	Location of the property	Location
livingArea	Living area of the property	float	Required for house, apartment,apartment_building plausible values between 15m² and 200m² for apartmentand between 40m² and 450m² for house
landArea	Land area of the property	float	Required for house, apartment_building plausible values between 50m² and 1000m²
buildingYear	Building year of the property	integer	Required for house, apartment plausible values between 1800 and current year
condition	Condition of the property	Condition	Required for house
quality	Quality of the interior of the property	Quality	Required for house

Response

{
  "value": 1049382.71,
  "lowerValue": 1234567.89,
  "upperValue": 1419753.07,
  "currency": "EUR",
  "confidence": "medium",
  "meta": {
    "url": "https://quis.de/app/dashboard?coordinate=53.56238135,9.91097785903008",
    "version": "2.10.0"
  }
}

Field	Description	Type	Remarks
value	Estimated market value of the property	float
lowerValue	Lower bound of the estimated market value of the property	float
upperValue	Upper bound of the estimated market value of the property	float
currency	Currency of the valuation	Currency
confidence	Confidence of the valuation	Confidence
meta	Meta information of the API	Meta

Confidence

poor, medium, high