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 1000
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.9.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


© 2020-2024 QUIS® ist ein Service der Analyse & Konzepte immo.analytics GmbH