Authenticatie, invoer en resultaat

Vraag een duurzaamheidsadvies op basis van het adres.

POST https://api.altum.ai/v2/sustainability/apartments/delta

Met deze endpoint ontvang je een antwoord van de Altum AI Verduurzaming API Delta, speciaal voor appartementen, over duurzaamheid en de Ecovalue, door postcode, huisnummer en huisletter/toevoeging mee te geven.

Headers

Naam

Type

Omschrijving

Content-Type

string

application/json

x-api-key*

string

Unieke API sleutel van Altum. Maak er één aan op https://platform.altum.ai

Request Body

Naam

Type

Omschrijving

Voorbeeld

postcode*

string

Zes-cijferige postcode formaat

1234AB

housenumber*

integer

Huisnummer van het object

5

houseaddition

string

Huisnummertoevoeging

C

position

integer

1 = 'Hoek begane grond' 2 = 'Tussenwoning begane grond' 3 = 'Hoekwoning middenverdieping' 4 = 'Tussenwoning middenverdieping' 5 = 'Hoekwoning bovenste verdieping' 6 = 'Tussenwoning bovenste verdieping' 7 = 'Volledig bovenste verdieping/penthouse'

3

floors

integer

Heeft de woning één of meerdere verdiepingen?

1 = 'Eén verdieping'

2 = 'Meerdere verdiepingen'

1

back_facade

boolean

Heeft de woning een achtergevel?

Nee (false)
Ja (true)

false

build_year

integer

Bouwjaar

1956

inner_surface_area

float

Totale woonoppervlakte (m²)

90

apartment_type

integer

1 = 'Galerijflat' 2 = 'Portiekflat' 3 = 'Corridorflat' 4 = 'Maisonnette' 5 = 'Benedenwoning' 6 = 'Bovenwoning' 7 = 'Portiekwoning

wall_insulation

integer

Bekijk Maatregelen

2

target_wall_insulation

integer

Bekijk Maatregelen

4

floor_insulation

integer

Bekijk Maatregelen

1

target_floor_insulation

integer

Bekijk Maatregelen

4

sloped_roof_insulation

integer

Bekijk Maatregelen

2

target_sloped_roof_insulation

integer

Bekijk Maatregelen

4

flat_roof_insulation

integer

Bekijk Maatregelen

2

target_flat_roof_insulation

integer

Bekijk Maatregelen

4

living_room_windows

integer

Bekijk Maatregelen

1

target_living_room_windows

integer

Bekijk Maatregelen

3

bedroom_windows

integer

Bekijk Maatregelen

1

target_bedroom_windows

integer

Bekijk Maatregelen

4

installation

integer

Bekijk Maatregelen

4

target_installation

integer

Bekijk Maatregelen

4

shower

integer

Bekijk Maatregelen

1

target_shower

integer

Bekijk Maatregelen

2

ventilation

integer

Bekijk Maatregelen

2

target_ventilation

integer

Bekijk Maatregelen

3

solar_panels

list

Bekijk Maatregelen

cooling

integer

Is er een koelsysteem aanwezig?

1 = Geen koeling

2 = Airconditioning, directe luchtkoeling

target_cooling

integer

Is er een koelsysteem aanwezig?

1 = Geen koeling

2 = Airconditioning, directe luchtkoeling

electric_cooking

integer

Wat wordt gebruikt om te koken?

1 = Gasfornuis

2 = Elektrisch fornuis

Als de installatie in [6,7] zit -> 2 anders 1

target_electric_cooking

integer

Wat wordt gebruikt om te koken?

1 = Gasfornuis

2 = Elektrisch fornuis

Als de installatie in [6,7] zit -> 2 anders 1

inhabitants

integer

Aantal bewoners

4

gas_usage

float

Overschrijft het geschatte jaarlijkse gasverbruik (m³)

1000

heat_usage

float

Overschrijft het opgegeven jaarlijkse warmteverbruik (GJ)

45

electricity_usage

float

Overschrijft het opgegeven jaarlijkse elektriciteitsverbruik (kWh)

2600

electricity_generation

float

Totale jaarlijkse elektriciteitsopbrengst van zonnepanelen (kWh) Netto verbruik = verbruik − opbrengst

800

exclude_vat

boolean

Prijzen zijn inclusief of exclusief btw.

0 = Inclusief btw

1 = Exclusief btw

Standaard: 0

cost_indicators

dict

Bekijk Kostenindicatoren

wall_filters

dict

Bekijk Maatregelfilters

roof_filters

dict

Bekijk Maatregelfilters

floor_filters

dict

Bekijk Maatregelfilters

fetch_definitive_label

integer

Ophalen van het definitieve energielabel uit EP-online

0 = Uitschakelen

1 = Inschakelen

Standaard: 0

eco_delta

boolean

Ophalen van de Ecowaarde

0 = Uitschakelen

1 = Inschakelen

Standaard: 1

Voor de meest nauwkeurige resultaten is het aan te raden zowel de positie als het aantal verdiepingen van het appartement op te geven.

Vraag een duurzaamheidsadvies op basis van BagID op. Nog te bepalen (TBD).

PreviousChangelog

NextAPI sleutel informatie

Last updated 26 days ago

{
  "tip": null,
  "warnings": [
    {
      "code": "11",
      "description": "Current building with energy label C already meets default target_label A."
    }
  ],
  "address": {
    "housenumber": 227,
    "postcode": "3024XL",
    "houseaddition": "B",
    "street": "Willem Buytewechstraat",
    "city": "Rotterdam",
    "location": {
      "lat": 51.90761152288453,
      "lon": 4.451398538183942
    }
  },
  "building": {
    "build_year": 1927,
    "inner_surface": 74,
    "floor_surface": 0,
    "roof_surface": 0,
    "wall_surface": 50.2,
    "glass_living_room_surface": 13.4,
    "number_of_doors": 5,
    "floors": "Single",
    "main_type": "Appartement",
    "sub_type": null
  },
  "label": {
    "current": "C",
    "potential": "B"
  },
  "provided_label": {
    "temporary": "G",
    "definitive": null,
    "definitive_type": null,
    "definitive_validity": null
  },
  "BENG2": {
    "current": 245,
    "potential": 181
  },
  "meta": null,
  "CO2": {
    "current": 2357,
    "potential": 2141
  },
  "financial": {
    "total_investment": 2309,
    "total_saving": 164,
    "months_to_pay_off": 168,
    "eco_value": 0,
    "savings_monthly": 14,
    "energy_cost_monthly": {
      "current": 175,
      "potential": 161
    },
    "energy_cost_yearly": {
      "current": 2096,
      "potential": 1932
    },
    "return_on_investment": "0.52%",
    "loan": {
      "monthly_payment": 10
    }
  },
  "gas_usage": {
    "current": 888,
    "potential": 769
  },
  "electricity_usage": {
    "current": 2262,
    "potential": 2255
  },
  "city_heating_usage": {
    "current": 0,
    "potential": 0
  },
  "solar_panel_yield": {
    "current": 0,
    "potential": 0
  },
  "energy_prices": {
    "variable_gas_price": 1.359,
    "variable_electricity_price": 0.27,
    "solarpanel_watt_peak_per_m2": 250
  },
  "solar_panels": {
    "current": null,
    "potential": null
  },
  "measures": {
    "wall_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 2
      },
      "after": {
        "desc": "Goed",
        "value": 3,
        "points": 5
      },
      "investment": 2309,
      "savings": 164,
      "co2_reduce": 215,
      "BENG2": "100",
      "gas_savings": 119,
      "electricity_savings": 7
    },
    "floor_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "roof_insulation": {
      "before": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Geen",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "living_room_windows": {
      "before": {
        "desc": "Enkel glas",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Enkel glas",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "installation": {
      "before": {
        "desc": "HR combi ketel",
        "value": 4,
        "points": 15
      },
      "after": {
        "desc": "HR combi ketel",
        "value": 4,
        "points": 15
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "shower": {
      "before": {
        "desc": "Geen Douche WTW",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "Geen Douche WTW",
        "value": 1,
        "points": null
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "cooling": {
      "before": {
        "desc": "No cooling",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "No cooling",
        "value": 1,
        "points": null
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "ventilation": {
      "before": {
        "desc": "Natuurlijke ventilatie",
        "value": 1,
        "points": 0
      },
      "after": {
        "desc": "Natuurlijke ventilatie",
        "value": 1,
        "points": 0
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "solar_panels": {
      "before": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "after": {
        "desc": "0",
        "value": 0,
        "points": null
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    },
    "electric_cooking": {
      "before": {
        "desc": "Gas stove",
        "value": 1,
        "points": null
      },
      "after": {
        "desc": "Gas stove",
        "value": 1,
        "points": null
      },
      "investment": 0,
      "savings": 0,
      "co2_reduce": 0,
      "BENG2": "0",
      "gas_savings": 0,
      "electricity_savings": 0
    }
  },
  "response_meta": null
}

{
  "detail": "There was an error parsing the body"
}

{
  "detail": "Address not found in database, combination of zip code and house number"
}

{
  "detail": "There are no measures to suggest for this combination of input."
}

{
  "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": "For a given custom cost make sure the parameter 'value' is provided."
}
{
  "detail": "For a given improvement cost make sure all four parameters: 'material', 'work', 'saving_material' and 'saving _work' are provided."
}