# Veelgestelde vragen (FAQ)

### Welke zoekcriteria moet ik gebruiken?

De standaardwaarde is ''**laagste investeringskosten''**. Bij deze zoekmethode wordt ook gezocht naar vergelijkbare woningen die een **hoger energielabel** hebben dan het opgegeven doel.

Bij de andere drie zoekcriteria gebeurt dit niet.

**Voorbeeld:**\
De beginsituatie is een woning met energielabel **F**. Wanneer je zoekt naar label **C**, worden woningen met label **C**, **B** en **A** meegenomen in de vergelijking. Als een woning met label **B** lagere investeringskosten heeft dan woningen met label **C**, dan wordt de **B-variant** als resultaat teruggegeven.

### Moet ik alle kenmerken meesturen in de request?

Nee. Alleen de invoer die nodig is om de **woning te identificeren** is verplicht.

Voor de overige kenmerken haalt de API **standaardwaarden uit de database**. Het is daarom niet nodig om voor elke feature input mee te sturen.

### Waarom krijg ik een Ecowaarde van 0,0 terug?

Dit kan verschillende oorzaken hebben:

* Het adres wordt niet correct herkend wanneer bijvoorbeeld `"addition": "string"` wordt meegestuurd. De API interpreteert dit dan als een **huisnummertoevoeging**.
* Het **huidige energielabel** en het **doel- of voorgestelde energielabel** zijn gelijk.
* Er is een **fout in de API-call**, bijvoorbeeld doordat de invoer niet voldoet aan het schema.

### Waarom is de Ecowaarde relatief laag?

In combinatie met andere woningkenmerken kan een **kleine verduurzamingsstap** al leiden tot een labelverbetering (bijvoorbeeld van **E naar D**). De **marktwaarde-stijging** blijft in dat geval vaak beperkt.

### Waarom krijg ik andere resultaten wanneer ik een budget gebruik?

Wanneer je een **budget of maximale investering** opgeeft, gebruikt de API standaard het zoekcriterium **flexibel (code: 2)**.

Wanneer je **geen maximuminvestering** opgeeft, gebruikt de API **strict (code: 0)**.

Wil je dit aanpassen, geef dan expliciet de gewenste **search\_options** mee in de API-call.

### Waarom tellen de besparingen van de afzonderlijke maatregelen niet op tot de totale besparing?

Maatregelen beïnvloeden elkaar. De API houdt rekening met het **gecombineerde effect van maatregelen**. Daardoor kan de **totale besparing** afwijken van de optelsom van de individuele besparingen.

### Waarom wordt een woning niet gevonden?

Wanneer de Verduurzaming API een adres niet kan vinden of er onvoldoende data beschikbaar is voor berekeningen, krijg je de foutmelding:

`Address not found in database, combination of zip code and house number`

Dit kan onder andere komen doordat:

* Het adres niet bekend is bij **Kadaster of gemeente**
* Essentiële woningdata ontbreekt (bijvoorbeeld **woningtype**)
* Het object geen **woonfunctie** heeft maar bijvoorbeeld een **bedrijfspand, winkel of boerderij** is

### Hoe kan ik advies geven voor woningen die van het gas af willen?

Dit kan op verschillende manieren.

**Optie 1:** advies zonder aardgasgebruik

```
“natural_gas”: 2,
```

**Optie 2:** focus op isolatie en warmtepomp uitsluiten

```
“heat_pump_allowed”: 0,
"lock_measures": {
     "lock": [
       "installation", “shower”, “solar_panels”
     ]
},
```

### Wat als een woning al maatregelen heeft genomen of een ander energielabel heeft?

Je kunt de **huidige situatie** aanpassen door zelf kenmerken mee te sturen in de input. Bijvoorbeeld wanneer een woning al **zonnepanelen of vloerisolatie** heeft.

Om een zo realistisch mogelijk uitgangspunt te krijgen, kun je onder andere de volgende gegevens meegeven:

* Woonoppervlak
* Woningtype
* Bouwjaar
* Aantal bewoners
* Gas- of warmtenetverbruik
* Aanwezige zonnepanelen
* Huidige installatie
* Huidige isolatie van vloer, gevel en dak
* Ventilatiesysteem
* Aanwezige douche-WTW

Let op: het energielabel dat in het advies wordt gebruikt is **niet het definitieve energielabel uit EP-online (RVO)**. Dit label kan namelijk gebaseerd zijn op oudere normen of op onbekende maatregelen.

### Waarom ondersteunt deze API geen appartementen?

Op dit moment ondersteunt de Sustainability API **geen appartementen**.

Bij appartementen worden verduurzamingsmaatregelen meestal geregeld via de **Vereniging van Eigenaren (VvE)**, omdat onderdelen zoals:

* dak
* gevels
* vloer
* kozijnen

vaak **gemeenschappelijk eigendom** zijn.

Daarom zijn individuele maatregelen zoals isolatie, zonnepanelen of warmtepompen vaak alleen mogelijk met toestemming van de **VvE**.

Dit zal apart beschikbaar zijn in de [Verduurzaming API v2 Appartementen](/verduurzamen/verduurzaming-api-v2-appartementen.md).<br>

### Hoe houdt de API rekening met de NTA 8800-norm?

De berekeningen voor verduurzamingsmaatregelen en energie-impact zijn gebaseerd op de **NTA 8800-norm** voor energielabels.

### Waarom krijg ik een 400-foutmelding met de melding dat het doel niet binnen de investeringslimiet kan worden bereikt?

Deze fout ontstaat meestal wanneer er **te veel beperkingen** zijn opgegeven, bijvoorbeeld:

* een te hoog **doel-energielabel**
* een te lage **maximale investering**
* maatregelen die zijn **gelockt of uitgesloten**

**Mogelijke oplossingen:**

* verhoog of verwijder **max\_investment**
* verlaag **target\_label** (bijvoorbeeld van A naar C)
* verwijder **lock\_measures** of **exclude\_measures**

###


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altum.ai/verduurzamen/verduurzaming-api-v2/veelgestelde-vragen-faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.