> For the complete documentation index, see [llms.txt](https://docs.altum.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altum.ai/verduurzamen/nta-8800-energielabel-v2-api.md).

# NTA 8800 Energielabel v2 API

## Introductie

De NTA 8800 Energielabel API v2 schat de huidige energieprestatie van Nederlandse woningen op basis van de NTA 8800-methodiek: de officiële Nederlandse standaard voor het berekenen van energielabels.

Met de API kun je het huidige energielabel van een woning schatten en de aanwezige verduurzamingsmaatregelen ophalen. De API werkt met minimale adresinvoer, maar ondersteunt ook gedetailleerde woningkenmerken. Zo kun je per toepassing kiezen tussen snelheid en nauwkeurigheid.

Typische toepassingen zijn verduurzamingsplatformen, vastgoedtools, woningwaarderingsmodellen en financiële applicaties die schaalbaar inzicht nodig hebben in de energieprestatie van woningen.

### Kernmogelijkheden

#### Geschat energielabel berekenen

De API schat het huidige energielabel van een woning op basis van beschikbare gebouwdata en voorspellende modellen die aansluiten op de NTA 8800-methodiek.

Het resultaat bevat onder andere:

* Geschat energielabel: A++++ t/m G
* Geschatte BENG2-score: primair fossiel energiegebruik
* Geschatte energieverbruikswaarden
* Geschat verbruik voor gas, elektriciteit en stadsverwarming, inclusief CO₂-uitstoot
* Relevante duurzaamheidsindicatoren

Deze resultaten geven snel inzicht in het huidige energieprestatieniveau van een woning.

<figure><img src="/files/hONK8JUTU6Ebn4cVlce4" alt=""><figcaption><p>Range of Energy labels</p></figcaption></figure>

#### Herkenning van aanwezige energiemaatregelen

De API schat ook welke energiebesparende maatregelen op dit moment in de woning aanwezig zijn.

Voorbeelden hiervan zijn:

* Gevelisolatie
* Dakisolatie
* Vloerisolatie
* Type beglazing
* Type verwarmingsinstallatie
* Ventilatiesystemen
* Zonnepanelen

Deze maatregelen vormen de basis voor de berekening van de geschatte energieprestatie.

### Flexibel invoermodel

De API is ontworpen om te werken met verschillende niveaus van invoerdetail.

#### Minimale invoer

Gebruikers kunnen een schatting van de energieprestatie ophalen met alleen:

* Postcode
* Huisnummer
* Huisnummertoevoeging

Op basis van deze gegevens schat de API de gebouwkenmerken met behulp van eigen datasets en statistische modellen.

#### Gedetailleerde woninginvoer

Voor een hogere nauwkeurigheid kunnen gebruikers aanvullende informatie meegeven, zoals:

* Woningtype
* Bouwjaar
* Gebruiksoppervlakte
* Isolatieniveaus
* Verwarmingsinstallatie
* Zonnepanelen
* Ventilatiesystemen

Door meer gedetailleerde woningkenmerken mee te geven, zijn er minder modelaannames nodig en verbetert de nauwkeurigheid van het geschatte energielabel.

### Nauwkeurigheid en methodiek

De API schat het huidige energielabel met een combinatie van statistische modellen, machine learning en berekeningen op basis van de NTA 8800-methodiek.

Omdat volledige gebouwdata vaak niet beschikbaar is, richt het model zich op de gebouwkenmerken met de meeste invloed. Hiervoor gebruiken we voorspellende modellen die zijn getraind op grote datasets met Nederlandse woningen.

### Voorspelling met machine learning

Als directe data over een woning niet beschikbaar is, gebruikt de API machinelearningmodellen om gebouwkenmerken en energieprestatie-indicatoren te schatten.

{% hint style="info" %}
Migreer je vanaf v1? Begin dan met de [**Migratiehandleiding voor woningen** ](/verduurzamen/nta-8800-energielabel-v2-api/woningen/migratiehandleiding-v1-v2.md)of [**Migratiehandleiding voor appartementen.**](/verduurzamen/nta-8800-energielabel-v2-api/appartementen/migratiehandleiding-v1-v2.md)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.altum.ai/verduurzamen/nta-8800-energielabel-v2-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.