) |
| Content-Type | string | application/json |
#### Request Body
| Name | Type | Description |
| ----------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| bag\_id\* | string | 16 cijfers BAG\_ID |
| inner\_surface\_area | Number | 100 |
| build\_year | Number | 2001 |
| house\_type | Number | huidige woningtype: '2 onder 1 kap' = 1, 'hoekwoning' = 2, 'tussenwoning' = 3, 'vrijstaand' = 4 of 'appartement' = 5 |
| installation | Number | huidig installatietype - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| wall\_insulation | Number | huidige muurisolatie - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| roof\_insulation | Number | huidige dakisolatie - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| floor\_insulation | Number | huidige vloerisolatie - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| living\_room\_windows | Number | huidige woonkamerramen - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| bedroom\_windows | Number | huidige slaapkamerramen - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| shower | Boolean | huidige douche WTW - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| ventilation | Number | huidige ventilatie - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| solar\_panels | Number | huidige zonnepanelen in m2 of totaal watt-piekvermogen in W - zie [maatregelen](/verduurzamen/verduurzaming-api/measures.md) |
| solarpanel\_watt\_peak | Number | huidige zonnepanelen watt piekvermogen per m2 |
| watt\_panels | Boolean | neem aan dat de invoer van zonnepanelen in W (0) of m2 (1) is. Standaard = 1 |
| inhabitants | Integer | aantal mensen dat in het huis woont |
{% tabs %}
{% tab title="200: OK Succesvolle reactie" %}
```
{
"Output": {
"post_code": "2771DS",
"house_number": 87,
"house_addition": null,
"build_year": 1961,
"inner_surface_area": 151,
"house_type": "vrijstaand",
"installation": 4,
"wall_insulation": 2,
"roof_insulation": 2,
"floor_insulation": 2,
"living_room_windows": 2,
"ventilation": 1,
"bedroom_windows": 2,
"shower": 0,
"solar_panels": 15,
"solarpanel_watt_peak": 300,
"CO2": 3084,
"definitive_energy_label": "C",
"definitive_energy_label_type": "NEN7120",
"definitive_energy_label_validity_date": "2030-12",
"current_estimated_energy_label": "B",
"current_estimated_BENG2_score": 167,
"estimated_gas_usage": 3108,
"estimated_energy_usage": 760
}
}
```
{% endtab %}
{% tab title="422: Unprocessable Entity Verkeerd invoerformaat" %}
```
{
"detail": [
{
"loc": [
"body",
"postcode"
],
"msg": "string does not match regex \"^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$\"",
"type": "value_error.str.regex",
"ctx": {
"pattern": "^(?!1000|1001|1002|1003|1004|1005|1006|1007|1008|1009|1010)[1-9][0-9]{3}[A-Z]{2}$"
}
}
]
}
```
{% endtab %}
{% tab title="400: Bad Request Mislukte reactie" %}
```
{
"detail": "Address not found in database, combination of zip code and house number."
}
```
```
{
"detail": "No measures suggested for this combination of input."
}
```
```
{
"detail": "Code used in exclude_measure parameter is invalid"
}
```
```
{
"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": "Gevelisolatie code ongeldig"
}
```
{% endtab %}
{% tab title="301: Moved Permanently Appartementfout" %}
```
{
"detail": "Unable to check apartment."
}
```
{% endtab %}
{% tab title="303: See Other Huistypefout" %}
```
{
"detail": "The house type of the given house was not found in database. Use house_type parameter instead."
}
```
{% endtab %}
{% tab title="500: Internal Server Error Service is niet beschikbaar en/of niet beschikbaar" %}
```
{
"message": "Internal server error"
}
```
{% endtab %}
{% tab title="404: Not Found Als BagId wordt gebruikt in plaats van Adres" %}
{
"detail": "Could not find any object with your BAG ID."
}
{% endtab %}
{% tab title="401: Unauthorized Geen toegang" %}
```
{
'Output': 'Please use https://api.altum.ai or visit https://mopsus.altum.ai to make your request.'
}
```
{% endtab %}
{% tab title="403: Forbidden Verboden" %}
```
{
"message": "Missing Authentication Token"
}
```
{% endtab %}
{% endtabs %}
## Request body
#### Voorbeeld verzoeken
{
"post_code": "4709BM",
"house_number": 1,
"house_addition": "A",
"installation": 1,
"wall_insulation": 3,
"roof_insulation": 2,
"floor_insulation": 2,
"living_room_windows": 3
}
{
"bag_id": "0637010000264937",
"installation": 1,
"wall_insulation": 3,
"roof_insulation": 2,
"floor_insulation": 2,
"living_room_windows": 3
}
---
# 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/nta-8800-energielabel-api/authenticatie-invoer-en-resultaat.md?ask=
```
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.