Authentication, input and response
Fetch real estate information for a houseaddress
POST
https://api.altum.ai/location-data
Headers
Request Body
{
"output": {
"bag": {
"bagid": "0355010000760136",
"postcode": "3709JL",
"housenumber": "1",
"houseaddition": "A3",
"valuationdate": null,
"houseletter": null,
"houseaddress": "3709JL-1-A3",
"city": "Zeist",
"street": "Laan van Rijnwijk",
"street_type": "Weg",
"object_function": "woonfunctie",
"build_year": "1956",
"num_id": "355200000760135",
"opr_id": "355300000715015",
"inner_surface_area": "63",
"outer_surface_area": "32371.0",
"object_status": "Verblijfsobject in gebruik",
"type_adressable_object": "Verblijfsobject",
"city_status": "Woonplaats aangewezen",
"neighbourhood_code": "BU03550403",
"longitude": "5.252295887993648",
"latitude": "52.06943069547836",
"wpl_id": "2821",
"section_letter": "F",
"public_space_status": "Naamgeving uitgegeven",
"building_status": "Pand in gebruik",
"pnd_id": "355100000716502",
"district_code": "35504.0",
"parcel_number": "841.0",
"garden_orientation_cat": "North-East",
"garden_orientation_num": "50.63422057165001",
"municipality_code": "355.0",
"parcel_number_rotation": "0.0",
"status_numbering": "Naamgeving uitgegeven"
},
"amenities": {
"railway_station": "933.6281294349901",
"school": "713.9065745947164",
"shopping_mall": "11497.698966307216",
"highway_entry": "1292.2849136753132",
"police_station": "1819.0025958902368",
"convenience_store": "1376.018421818083",
"bus_stop": "264.25793815501623",
"hospital": "2519.184016411734"
},
"locality": {
"province": "Utrecht",
"municipality": "Zeist",
"city": "Zeist",
"neighborhood_code": "BU03550403",
"neighborhood_name": "Driebergseweg",
"neighborhood_data": {
"inhabitants": {
"total": "325.0",
"men": "135.0",
"women": "190.0"
},
"age": {
"0_14": "15.0",
"15_24": "15.0",
"25_44": "35.0",
"45_64": "95.0",
"65_plus": "165.0"
},
"household_composition": {
"total": "225.0",
"single": "155.0",
"without_kids": "50.0",
"with_kids": "15.0",
"average_household_size": "1.5"
}
},
"postcode_data": {
"house_types": {
"corner": "0.0",
"detached": "1.0",
"terraced": "0.0",
"semi_detached": "0.0",
"linked": "0.0",
"linked_semi_detached": "0.0",
"end": "0.0",
"single_family": "0.0",
"gallery": "0.0",
"porch_flat": "0.0",
"porch_house": "0.0",
"corridor": "0.0",
"maisonnette": "0.0",
"downstairs": "0.0",
"upstairs": "0.0",
"multi_family": "106.0"
},
"average_price_per_square_meter": "1416.6375",
"average_transaction_price": "113331.0",
"transactions_past_12_months": "4.0",
"population_density_km2": "257",
"average_for_sale_duration": null,
"average_asking_price": "198000.0",
"percent_houses_rented": null,
"percent_houses_owned": null,
"foundation": {
"physical_region": {
"description": "Hogere Zandgronden",
"short": "hz",
"translation": "Higher Sandy Soils"
},
"ground": {
"description": "Niet kwetsbaar gebied – 80-100 %",
"code": "25.0",
"translation": "Not sensitive area - 80-100%"
}
}
}
}
}
}
{
"detail": "The requested object is currently not on the market."
}
{
'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
"message": "Missing Authentication Token"
}
{
"message": "Internal server error"
}
{
"detail": [{
"loc": ["body", 40],
"msg": "Expecting value: line 3 column 17 (char 40)",
"type": "value_error.jsondecode",
"ctx": {
"msg": "Expecting value",
"doc": "{\n\t\"postcode\":\"3038VX\",\n\t\"housenumber\": re,\n\t\"addition\": \"A01\"\n}",
"pos": 40,
"lineno": 3,
"colno": 17
}
}]
}
Request body
Example request
{
"postcode": "3709JL",
"housenumber": "1",
"houseaddition": "A3"
}
Last updated