Reference Price

The resource referenceprice represents a reference price for the given location. A location is represented by either a countryId, a regionId, a cityId, and a districtId or by WGS84-coordinates (latitude and longitude). The result represents the reference prices for the neighbourhood and the quarter. Creating or modifying reference prices is not supported by the API.

GET /ibw/v2.2/referenceprice/region/{regionId}/city/{cityId}/district/{districtId}

(same as above just JSONP)

GET /ibw/v2.2/referenceprice/jsonp/region/{regionId}/city/{cityId}/district/{districtId}

GET /ibw/v2.2/referenceprice/latitude/{latitude}/longitude/{longitude}

Supported media types:
XML
JSON

Request


For the request with IS24 geo hierarchy
  • regionId - id of a federal state of the IS24-Geo-Hierarchy
  • cityId - id of a city of the IS24-Geo-Hierarchy
  • districtId - id of a district of the IS24-Geo-Hierarchy
For the request with WGS84 coordinates
  • latitude - the latitude of the point you wish to use for the request (WGS84 coordinate - required)
  • longitude - the longitude of the point you wish to use for the request (WGS84 coordinate - required)

Query Parameters

realEstateType

PARAMETER VALUE
APARTMENT_RENT 0
HOUSE_RENT 1
APARTMENT_BUY 2
HOUSE_BUY 3

siteArea only for houses. the size of the siteArea as integer. Minimum valid value is 0.

firstTimeUse to make sure that new building prices are received although construction year is older than this year. If no firstTimeUse is given, portfolio real estate will be assumed.

livingArea the size of the livingArea. If no livingArea is available the service assumes 100 sqm. Minimum valid value is 0.

price The price of the real estate in EUR. Minimum valid value is 1. For realEstateType APARTMENT_ the price is per sqm and for HOUSE_ is the price is the total price.

possible values for objectCategory:

PARAMETER VALUE
no information 0
roof storey 3
maisonette 7
bungalow 15
semi detached house 17
single family house 18
country house 20
villa 24
single family house 24
terrace house 25
wooden house 27
freehold flat 38
terraced flat 40
ground floor 117
apartment 118
special real estate 119
single family house (detached) 122
mid terrace house 123
end terrace house 124
apartment (other) 126
raised ground floor 127
half basement 128

constructionYear The year of construction of a real estate. This parameter is used to determine the age class of a realestate. The construction year must be a 4 digit number smaller or equals the current year and greater or equal then 0 (optional). If no constructionYear is given, portfolio real estate will be assumed.

Response

JSON:

{
  "averagePriceTotal": 690,
  "averagePricePerSqm": 6.9,
  "simpleStd": 1,
  "twiceStd": 2,
  "lowerSimpleStd": 5.7,
  "higherSimpleStd": 8.1,
  "lowerTwiceStd": 4.5,
  "higherTwiceStd": 9.3,
  "livingAreaAvg": 61,
  "siteAreaAvg": null,
  "districtName": "Berlin - Adlershof (Treptow)",
  "comparisonCount": 15781,
  "newBuilding": false
}