Authentication, input and response

Transaction API

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

This endpoint allows you to retrieve Kadaster transaction data for an object.

Headers

Name	Type	Description
x-api-key*	string	Unique API Key from Altum. Create one via Mopsus(https://mopsus.altum.ai)
Content-Type	string	application/json

Request Body

Name	Type	Description
postcode*	string	Zipcode of the object
valuationdate	number	Enter as YYYYMMDD, gives newest transaction till that date. Default is TODAY
houseaddition	string	House letter and addition of the object
housenumber*	number	House number of the object

400: Bad Request Unsuccessful response

{
  "Output": "The given house address not found in database, the combination of Post Code, House Number and House Addition does not exist."
}

422: Unprocessable Entity Wrong input format

401: Unauthorized No access

403: Forbidden Forbidden

500: Internal Server Error Service is not available and/or down

200: OK Successful response

FREE Ping for availability

Post object data to receive availability of transaction data

POST https://api.altum.ai/transaction/ping

This endpoint allows you to get the availability of the transaction data from our database. A POST request requires a body parameter (Address).

Headers

Name	Type	Description
x-api-key*	string	API Key from Altum. Create one via Mopsus(https://mopsus.altum.ai)
Content-Type	string	application/json

Request Body

Name	Type	Description
postcode*	string	Zipcode of the object
valuationdate	number	Enter as YYYYMMDD, gives newest transaction till that date. Default is TODAY
houseaddition	string	House letter and addition of the object
housenumber*	number	House number of the object

422: Unprocessable Entity Wrong input format

{
	"detail": [
		{
			"loc": [
				"body",
				43
			],
			"msg": "Expecting value: line 3 column 18 (char 43)",
			"type": "value_error.jsondecode",
			"ctx": {
				"msg": "Expecting value",
				"doc": "{\n  \"postcode\": \"2201PZ\",\n  \"housenumber\": a,\n  \"valuationdate\": \"20121001\"\n}",
				"pos": 43,
				"lineno": 3,
				"colno": 18
			}
		}
	]
}

401: Unauthorized No access

403: Forbidden Forbidden

500: Internal Server Error Service is not available and/or down

200: OK Successful response

Request body

Example request

{
	"postcode": "2728KH",
	"housenumber": 5
}