# Zoekcriteria

Om het duurzaamheidsadvies te optimaliseren is de API in staat om naast het doel energielabel ook een zoekcriteria functie te verwerken.

#### Zoekcriteria - "search\_criteria"

De gebruikte zoekcriteria voor het duurzaamheidsadvies. De verschillende criteria kunnen verschillende resultaten opleveren.

* Syntax: 'search\_criteria'&#x20;
* Vereist: Nee
* Waardes: Integer, 0 to 4
* Standaard: 2&#x20;
* Omschrijving:&#x20;
  * 0 = laagste investeringskosten
  * 1 = laagste jaarlijkse energiekosten
  * 2 = hoogste financiële opbrengst
  * 3 = hoogste BARe (de verhouding tussen de jaarlijkse besparing op energiekosten en de totale investering)
  * 4 = laagste BENG2 score (best mogelijke energielabel)

**Resultaatselectie op basis van gebruiker input**

Het uiteindelijke resultaat wordt bepaald op basis van het ingevoerde criterium, met mogelijke restricties zoals een maximale investering of een doellabel.

* **Maximale investering**: Filtert resultaten waarbij de totale investering onder de limiet ligt.
* **Doellabel**: Filtert resultaten waarbij het energielabel ten minste aan de doelwaarde voldoet.
* **Strikt doellabel**: Indien "energylabel\_strict": 1, worden alleen resultaten teruggegeven die exact overeenkomen met het doellabel.
* **Criteriumgebaseerde selectie**: Na filtering wordt het uiteindelijke resultaat bepaald op basis van het criterium.

Criteria-opties:

* **0: Laagste investeringskosten** - Resultaat met de laagste totale investering. Dit resulteert in maatregelen die voldoende verbetering in BENG2 opleveren om aan het energielabeldoel te voldoen.
* **1: Laagste jaarlijkse energiekosten** - Resultaat met de laagste jaarlijkse energiekosten, met de focus op maatregelen die de maandelijkse energierekening het meest verlagen.
* **2: Hoogste financieel rendement** - Resultaat met het hoogste financiële voordeel binnen het energielabelbereik.
* **3: Hoogste BARe** - Woning met de hoogste BARe-waarde, wat de beste verhouding tussen energiekosten en totale investering aangeeft.
* **4: Laagste BENG2** - Woning met de laagste BENG2-score, wat de beste energetische prestaties aangeeft.


---

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