🇳🇱
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
    • EPC API
      • Changelog
      • API-sleutel Informatie
      • Authenticatie, invoer en resultaat
      • 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
  • Bepaal het geschatte huidige of potentiële NTA 8800 energielabel
  • Bepaal het geschatte huidige of potentiële NTA 8800 energielabel
  • Request body
  1. API's
  2. NTA 8800 Energielabel API

Authenticatie, invoer en resultaat

Details over de invoer-, uitvoer- en authenticatievereisten.

Bepaal het geschatte huidige of potentiële NTA 8800 energielabel

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

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

post_code*

String

1234AB

house_number*

Number

1

house_addition

String

A

inner_surface_area

Number

100

build_year

Number

2001

house_type

Number

huidige woningtype: '2 onder 1 kap' = 1, 'hoekwoning' = 2, 'tussenwoning' = 3, 'vrijstaand' = 4 of 'appartement' = 5

installation

Number

wall_insulation

Number

roof_insulation

Number

floor_insulation

Number

living_room_windows

Number

bedroom_windows

Number

shower

Boolean

ventilation

Number

solar_panels

Number

solarpanel_watt_peak

Number

huidige zonnepanelen watt piekvermogen per m2

watt_panels

Boolean

neem aan dat de invoer van zonnepanelen in W (0) of m2 (1) is. Standaard = 1

inhabitants

Integer

aantal mensen dat in het huis woont

{
	"Output": {
		"post_code": "2771DS",
		"house_number": 87,
		"house_addition": null,
		"build_year": 1961,
		"inner_surface_area": 151,
		"house_type": "vrijstaand",
		"installation": 4,
		"wall_insulation": 2,
		"roof_insulation": 2,
		"floor_insulation": 2,
		"living_room_windows": 2,
		"ventilation": 1,
		"bedroom_windows": 2,
		"shower": 0,
		"solar_panels": 15,
		"solarpanel_watt_peak": 300,
		"CO2": 3084,
		"definitive_energy_label": "C",
		"definitive_energy_label_type": "NEN7120",
		"definitive_energy_label_validity_date": "2030-12",
		"current_estimated_energy_label": "B",
		"current_estimated_BENG2_score" : 146,
		"current_estimated_BENG2_score": 167,
		"estimated_gas_usage": 3108,
		"estimated_energy_usage": 760
	}
}
{
  "detail": [
    {
      "loc": [
        "body",
        "postcode"
      ],
      "msg": "string does not match regex \"^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$\"",
      "type": "value_error.str.regex",
      "ctx": {
        "pattern": "^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$"
      }
    }
  ]
}
{ 
    "detail": "Address not found in database, combination of zip code   and house number." 
}
{
     "detail": "No measures suggested for this combination of input."
}
{
     "detail": "Code used in exclude_measure parameter is invalid"
}
{
     "detail": "No housing variant with the selected installation options found with which the goal can be reached within the investment limit. Try again with different inputs and/or different search criteria."
}
{
     "detail": "Gevelisolatie code ongeldig"
}
{ 
    "detail": "Unable to check apartment."
}
{ 
    "detail": "The house type of the given house was not found in database. Use house_type parameter instead."
}
{
	"message": "Internal server error"
}
{
     "detail": "Could not find any object with your BAG ID." 
}
{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}

Bepaal het geschatte huidige of potentiële NTA 8800 energielabel

POST https://api.altum.ai/energylabel/bag

Gebruik BAG_id als alternatief voor post_code, house_number en house_addition. Alle andere invoer en uitvoer is gelijk.

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

bag_id*

string

16 cijfers BAG_ID

inner_surface_area

Number

100

build_year

Number

2001

house_type

Number

huidige woningtype: '2 onder 1 kap' = 1, 'hoekwoning' = 2, 'tussenwoning' = 3, 'vrijstaand' = 4 of 'appartement' = 5

installation

Number

wall_insulation

Number

roof_insulation

Number

floor_insulation

Number

living_room_windows

Number

bedroom_windows

Number

shower

Boolean

ventilation

Number

solar_panels

Number

solarpanel_watt_peak

Number

huidige zonnepanelen watt piekvermogen per m2

watt_panels

Boolean

neem aan dat de invoer van zonnepanelen in W (0) of m2 (1) is. Standaard = 1

inhabitants

Integer

aantal mensen dat in het huis woont

{
	"Output": {
		"post_code": "2771DS",
		"house_number": 87,
		"house_addition": null,
		"build_year": 1961,
		"inner_surface_area": 151,
		"house_type": "vrijstaand",
		"installation": 4,
		"wall_insulation": 2,
		"roof_insulation": 2,
		"floor_insulation": 2,
		"living_room_windows": 2,
		"ventilation": 1,
		"bedroom_windows": 2,
		"shower": 0,
		"solar_panels": 15,
		"solarpanel_watt_peak": 300,
		"CO2": 3084,
		"definitive_energy_label": "C",
		"definitive_energy_label_type": "NEN7120",
		"definitive_energy_label_validity_date": "2030-12",
		"current_estimated_energy_label": "B",
		"current_estimated_BENG2_score": 167,
		"estimated_gas_usage": 3108,
		"estimated_energy_usage": 760
	}
}
{
  "detail": [
    {
      "loc": [
        "body",
        "postcode"
      ],
      "msg": "string does not match regex \"^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$\"",
      "type": "value_error.str.regex",
      "ctx": {
        "pattern": "^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$"
      }
    }
  ]
}
{ 
    "detail": "Address not found in database, combination of zip code   and house number." 
}
{
     "detail": "No measures suggested for this combination of input."
}
{
     "detail": "Code used in exclude_measure parameter is invalid"
}
{
     "detail": "No housing variant with the selected installation options found with which the goal can be reached within the investment limit. Try again with different inputs and/or different search criteria."
}
{
     "detail": "Gevelisolatie code ongeldig"
}
{ 
    "detail": "Unable to check apartment."
}
{ 
    "detail": "The house type of the given house was not found in database. Use house_type parameter instead."
}
{
	"message": "Internal server error"
}
{
     "detail": "Could not find any object with your BAG ID." 
}
{
    'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
{
	"message": "Missing Authentication Token"
}

Request body

Voorbeeld verzoeken

{
  "post_code": "4709BM",
  "house_number": 1,
  "house_addition": "A",
  "installation": 1,
  "wall_insulation": 3,
  "roof_insulation": 2,
  "floor_insulation": 2,
  "living_room_windows": 3
}
{
  "bag_id": "0637010000264937",
  "installation": 1,
  "wall_insulation": 3,
  "roof_insulation": 2,
  "floor_insulation": 2,
  "living_room_windows": 3
}
PreviousChangelogNextAPI-sleutel Informatie

Last updated 6 months ago

huidig installatietype - zie

huidige muurisolatie - zie

huidige dakisolatie - zie

huidige vloerisolatie- zie

huidige woonkamerramen - zie

huidige slaapkamerramen - zie

huidige douche WTW - zie

huidige ventilatie - zie

huidige zonnepanelen in m2 of totaal watt-piekvermogen in W - zie

huidig installatietype - zie

huidige muurisolatie - zie

huidige dakisolatie - zie

huidige vloerisolatie - zie

huidige woonkamerramen - zie

huidige slaapkamerramen - zie

huidige douche WTW - zie

huidige ventilatie - zie

huidige zonnepanelen in m2 of totaal watt-piekvermogen in W - zie

maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen
maatregelen