🇳🇱
Altum AI
StartPlatformMonitorAltum AIContact
Nederlands
Nederlands
  • Altum AI API documentatie
  • Platform
    • Maandabonnementen
    • Jaarabonnementen
    • Onbeperkt gebruik abonnementen
    • Kadaster Transactie API abonnement
    • Changelog
  • Updates
  • Ontwikkelaars
    • Voer de eerste API-call uit
    • Sandbox
    • OpenAPI specificaties
    • API status
    • Credit API
  • Altum AI website
  • Tarieven
  • Vastgoed AI
    • Authenticatie, invoer en resultaat
    • Veelgestelde vragen (FAQ)
  • API's
    • Woningwaarde API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Accuratesse Indicator
      • Huisnummers & toevoegingen
      • Woningtypes
      • Parameters
      • Resultaat interpretatie
      • Veelgestelde vragen (FAQ)
    • Woningwaarde+ API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Huisnummers, letters & toevoegingen
      • Energielabel en binnen- en buitenoppervlakte
      • Resultaat interpretatie
    • Vraagprijs API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Huisnummers, letters & toevoegingen
      • Energielabel en binnen- en buitenoppervlakte
      • Resultaat interpretatie
    • Verduurzaming API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Energielabel
      • Advies verbeteren
      • Voorbeeld API verzoeken
      • Resultaat interpretatie
      • Energiekosten
      • Maatregelen uitsluiten
      • Zoekcriteria
      • Maatregelen
      • Isolatie waardes
      • Comfort score
      • CO2
      • Dekking
      • Kostentabel invoer
      • Veelgestelde vragen (FAQ)
    • NTA 8800 Energielabel API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Energielabel inzichten API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • WOZ API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
      • Veelgestelde vragen (FAQ)
      • PC6 gemiddelde WOZ waarde
    • Interactieve woningreferentie API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Visueel vergelijkbare woningen zoeken
      • Woningtypes
      • Vergelijkend zoeken functies
      • Resultaat interpretatie
    • Kadaster Transactie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Woningkenmerken API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Gebouw geometrie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Energie & klimaat API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Conditie score API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Foto Labelen API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Autosearch API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
    • Autosuggestie API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Fuzzy Search Support
      • Resultaat interpretatie
    • Verhuisdata API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Locatie-gegevens API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Woningtypes
      • Resultaat interpretatie
    • Huurreferentie API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Herbouwwaarde API
      • Changelog
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • Zonnepanelen dakenscan API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Resultaat interpretatie
    • WWS Punten API
      • Authenticatie, invoer en resultaat
      • API-sleutel Informatie
      • Specificaties voor een zelfstandige woning versie 01-01-2024
      • Specificaties voor een zelfstandige woning versie 01-07-2024
      • Specificaties niet-zelfstandige woning versie 01-01-2024
      • Resultaat interpretatie
      • Specificaties voor een niet-zelfstandige woning versie 01-07-2024
      • Inputuitleg voor versie 01-07-2024
  • API error codes
    • 429
    • 422
    • 403
Powered by GitBook
On this page
  • Retourneert de impact van een energielabelwijziging op de verkoopduur en het verschil tussen de verwachte transactieprijs en de vraagprijs
  • Request body
  1. API's
  2. Energielabel inzichten API

Authenticatie, invoer en resultaat

Retourneert de impact van een energielabelwijziging op de verkoopduur en het verschil tussen de verwachte transactieprijs en de vraagprijs

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

Headers

Name
Type
Description

x-api-key*

string

Unieke 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

1234AB

housenumber*

integer

1

houseaddition

string

A

current_energy_label

string

B

target_energy_label*

string

A+++

ecovalue

boolean

1 om Ecowaarde op te vragen, default is 0

{
	"current_insights": {
		"stratification": "('B', 'Dorpskern', 'vrijstaand', '1990-2004', '>150')",
		"mean_sales_duration": "124.0",
		"median_sales_duration": "144.0",
		"mean_diff_price": "28733.0",
		"median_diff_price": "42000.0"
	},
	"target_insights": {
		"stratification": "('A', 'Dorpskern', 'vrijstaand', '1990-2004', '>150')",
		"mean_sales_duration": "118.0",
		"median_sales_duration": "118.0",
		"mean_diff_price": "-12375.0",
		"median_diff_price": "-17250.0"
	},
	"delta": {
		"mean_sales_duration": "6.0",
		"median_sales_duration": "26.0",
		"mean_diff_price": "41108.0",
		"median_diff_price": "59250.0",
		"mean_diff_price_percentage": "143.1",
		"median_diff_price_percentage": "141.1",
		"ecovalue": "12872"
	}
}
{
   "Output": "The given house address not found in database, the combination of Post Code, House Number and House Addition does not exist."
}


{
   "Output": "The current energy label for the given house address not found in database. Please provide the current energy label."
}


{
   "Output": "We are not able to provide insights at the moment."
}
{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}

{
	"detail": [
		{
			"loc": [
				"body",
				101
			],
			"msg": "Expecting ',' delimiter: line 6 column 3 (char 101)",
			"type": "value_error.jsondecode",
			"ctx": {
				"msg": "Expecting ',' delimiter",
				"doc": "{\n  \"postcode\": \"2201PZ\",\n  \"housenumber\": 11,\n  \"houseaddition\": \"\",\n\t\"current_energy_label\": \"A\"\n  \"target_energy_label\": \"A\",\n\t\"ecovalue\": 1\n}",
				"pos": 101,
				"lineno": 6,
				"colno": 3
			}
		}
	]
}

Request body

Voorbeeld verzoek

{
  "postcode": "1015GS",
  "housenumber":58,
  "houseaddition": "A1",
  "target_energy_label": "A",
  "ecovalue": 1
}
PreviousEnergielabel inzichten APINextAPI-sleutel Informatie

Last updated 5 months ago