# Zoekcriteria

Om het **verduurzamingsadvies** te optimaliseren kan de API naast het **streefenergielabel** ook een **zoekcriterium** verwerken.

#### Zoekcriteria - "search\_criteria"

Het zoekcriterium bepaalt op basis van welk uitgangspunt het verduurzamingsadvies wordt berekend. Afhankelijk van het gekozen criterium kan de uitkomst verschillen.

* Syntax: 'search\_criteria'&#x20;
* Verplicht: Nee
* Type: Integer (1 t/m 4)
* Standaardwaarde: 3&#x20;
* Betekenis van de waarden (beschrijving):&#x20;
  * 1 = laagste investeringskosten&#x20;
  * 2 = laagste energiekosten
  * 3 = hoogste rendement op investering (ROI)
  * 4 = laagste BENG2-score (hoogste energielabel)

**Resultaatselectie op basis van gebruikersinvoer**

Het uiteindelijke resultaat wordt bepaald op basis van het gekozen criterium en eventuele ingestelde beperkingen, zoals een maximale investering of een streefenergielabel.

* **Maximale investering**\
  Filtert resultaten waarbij de totale investering onder de ingestelde limiet blijft.
* **Streefenergielabel (doel), oftewel** `"targetlabel"` \
  Filtert resultaten waarbij het energielabel gelijk is aan of beter is dan het opgegeven doel.
* **Strikt streefenergielabel (doel)**\
  Wanneer `"energylabel_strict": 1` wordt gebruikt, geeft de API alleen resultaten terug die **exact** overeenkomen met het opgegeven streefenergielabel.
* **Selectie op basis van criterium**\
  Nadat de filters zijn toegepast, bepaalt het gekozen criterium welk resultaat uiteindelijk wordt geselecteerd.

**Beschrijving van de criteria:**

* **1: Laagste investeringskosten**\
  Geeft het resultaat met de laagste totale investering. De maatregelen leveren precies voldoende BENG2-verbetering op om het streefenergielabel te behalen.
* **2: Laagste energiekosten**\
  Geeft het resultaat met de laagste jaarlijkse energiekosten. De focus ligt op maatregelen die de maandelijkse energierekening het meest verlagen.
* **3: Hoogste rendement op investering (ROI)**\
  Geeft het resultaat met het hoogste financiële rendement binnen de bandbreedte van het energielabel.
* **4: Laagste BENG2-score**\
  Geeft het resultaat met de laagste BENG2-score. Dit staat voor de beste energieprestatie van de woning.


---

# 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/zoekcriteria.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.
