Authenticatie, invoer en resultaat

Haal herbouw gegevens op voor een object

POST https://api.altum.ai/rebuild

Headers

Name	Type	Description
x-api-key*	string	API-sleutel van Altum. Maak er een via Mopsus(https://mopsus.altum.ai)
Content-Type	string	application/json

Request Body

Name	Type	Description
postcode*	string	Postcode van het object
valuationdate	string	Waarderingsdatum (standaard is datum van boeking)
houseaddition	string	Huisbrieven en/of toevoegingen
housenumber*	number	Huisnummerof van het object
new_amenity	integer	1 = inclusief correctie voor nieuwe voorzieningenverzekering (badkamer, keuken en/of woonkamer)

200: OK Succesvolle reactie

{
  "Output": {
    "num_id": "0228200000047962",
    "bag_id": "0228010000047962",
    "pand_id": "0228100000030425",
    "postcode": "6741RD",
    "housenumber": "71",
    "houseaddition": "",
    "region": "Veluwe",
    "city": "Lunteren",
    "street": "Hindelaan",
    "build_year": "1990",
    "inner_surface_area": "160",
    "outer_surface_area": "340",
    "volume": "646",
    "energy_label": "B",
    "energy_calculation_method": "RDEL_2014_1",
    "energy_calculation_code": "NEN7120",
    "monument_status": null,
    "usage_indication": "Er is een gebruiker die tevens (mede)eigenaar is.",
    "building_status": "Pand in gebruik",
    "building_function": "woonfunctie",
    "rebuild_value": "671840",
    "woz_value": null,
    "number_of_rooms": "6",
    "number_of_building_layers": "3",
    "number_of_extrabuildings": null,
    "main_building_surface_area": null,
    "extrabuildings_surface_area": null,
    "listing_status": "Beschikbaar",
    "asking_price": "545000",
    "asking_price_date": "2020-09-04",
    "last_sold_date": "2020-09-04",
    "roof_type": "Zadeldak bedekt met pannen",
    "roof_construction": null,
    "roof_surfaces": [
      {
        "orientation": "NW",
        "area": "77.07044705650108",
        "perimeter": "44.77878166970827",
        "angle": "48.4"
      },
      {
        "orientation": "SE",
        "area": "23.2725546056168",
        "perimeter": "23.675635459999867",
        "angle": "48.3"
      },
      {
        "orientation": "SE",
        "area": "15.027296174805697",
        "perimeter": "11.481657061658073",
        "angle": "47.8"
      }
    ]
  }
}

400: Bad Request Mislukte reactie

{
	"Output": "The given house address was not found in database."
}

422: Unprocessable Entity Verkeerd invoerformaat

{
	"detail": [
		{
			"loc": [
				"body",
				"housenumber"
			],
			"msg": "value is not a valid integer",
			"type": "type_error.integer"
		}
	]
}

500: Internal Server Error Service is niet beschikbaar en/of niet beschikbaar

{
	"message": "Internal server error"
}

403: Forbidden Verboden

{
	"message": "Forbidden"
}

401: Unauthorized Geen toegang

{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}

Request body

Voorbeeld verzoeken

{
   "postcode" : "2771DS",
   "housenumber" : "87",
   "houseaddition":""
}