# Authenticatie, invoer en resultaat

## Verstuur objectgegevens om duurzaamheidsmaatregelen per object te ontvangen

<mark style="color:green;">`POST`</mark> `https://api.altum.ai/sustainability`

Vraag een verduurzamingadvies op basis van adres.

#### Headers

| Name                                        | Type   | Description                                                                     |
| ------------------------------------------- | ------ | ------------------------------------------------------------------------------- |
| Content-Type                                | string | application/json                                                                |
| x-api-key<mark style="color:red;">\*</mark> | string | Unieke API-sleutel van Altum. Maak er een via Mopsus(<https://mopsus.altum.ai>) |

#### Request Body

<table><thead><tr><th>Name</th><th width="218">Type</th><th>Description</th></tr></thead><tbody><tr><td>solar_panels_surface</td><td>integer</td><td>0 = Geen panelen, 1 = Maximaal de helft van de beschikbare ruimte, 2 = Volledig bedekt</td></tr><tr><td>natural_gas</td><td>number</td><td>0 = Aardgas toegestaan, 1 = Aardgas vereist, 2 = Aardgas niet toegestaan</td></tr><tr><td>post_code<mark style="color:red;">*</mark></td><td>string</td><td>postcode in zes-tekenformaat, b.v. 1234AB</td></tr><tr><td>house_number<mark style="color:red;">*</mark></td><td>number</td><td>huisnummer van het object, b.v. 1</td></tr><tr><td>house_addition</td><td>string</td><td>aanvulling op het huisnummer, b.v. A</td></tr><tr><td>target_label</td><td>string</td><td>gewenst doelenergielabel - standaard is energielabel A</td></tr><tr><td>inner_surface_area</td><td>integer</td><td>vierkante meter oppervlakte</td></tr><tr><td>inhabitants</td><td>integer</td><td>aantal mensen dat in het huis woont</td></tr><tr><td>replace_boiler</td><td>boolean</td><td>wel of niet toegestaan om de ketelinstallatie te vervangen</td></tr><tr><td>heat_pump_allowed</td><td>boolean</td><td>wel of niet mogen adviseren om een warmtepomp te implementeren</td></tr><tr><td>search_criteria</td><td>integer</td><td>0 = Laagste investeringskosten, 1 = Laagste energiekosten, 2 = Hoogste financiële rendement op investering, 3 = Hoogste BARe</td></tr><tr><td>gas_usage</td><td>integer</td><td>indien gebruikt, wordt het geschatte gasverbruik overschreven</td></tr><tr><td>max_investment</td><td>integer</td><td>maximale investering, gebruik 0 voor onbeperkt</td></tr><tr><td>watt_panels</td><td>integer</td><td>neem aan dat de invoer van zonnepanelen in W (0) of m2 (1) is. Standaard = 1</td></tr><tr><td>lock_measures</td><td>array</td><td>Sluismaatregelen uitgesloten van berekening</td></tr><tr><td>house_type</td><td>integer</td><td>Huidig woningtype: 1: halfvrijstaand, 2: hoekwoning, 3: rijtjeshuis, 4: vrijstaand huis en 5: appartement* (*dienst retourneert geen metingen voor een appartement.)</td></tr><tr><td>solar_panels</td><td>integer</td><td>huidige zonnepanelen in m2 (standaard) of totaal watt-piekvermogen in W (zie watt_panels) - zie <a href="measures">maatregelen</a></td></tr><tr><td>shower</td><td>integer</td><td>huidige douche WTW - zie <a href="measures">maatregelen</a></td></tr><tr><td>ventilation</td><td>integer</td><td>huidige ventilatie - zie <a href="measures">maatregelen</a></td></tr><tr><td>installation</td><td>integer</td><td>huidige installatie - zie <a href="measures">maatregelen</a></td></tr><tr><td>bedroom_windows</td><td>integer</td><td>huidige slaapkamerramen - zie <a href="measures">maatregelen</a></td></tr><tr><td>living_room_windows</td><td>integer</td><td>huidige woonkamerramen - zie <a href="measures">maatregelen</a></td></tr><tr><td>floor_insulation</td><td>integer</td><td>huidige vloerisolatie - zie <a href="measures">maatregelen</a></td></tr><tr><td>wall_insulation</td><td>integer</td><td>huidige muurisolatie - zie <a href="measures">maatregelen</a></td></tr><tr><td>roof_insulation</td><td>integer</td><td>huidige dakisolatie - zie <a href="measures">maatregelen</a></td></tr><tr><td>eco_delta</td><td>boolean</td><td>schakel het ophalen van ecowaarde uit met 0, standaard is 1</td></tr><tr><td>improvement_costs</td><td>array</td><td>kosten voor inputverbetering - zie <a href="cost-table-input">kostentabel</a></td></tr><tr><td>heat_usage</td><td>integer</td><td>ingangsstroom warmteverbruik</td></tr><tr><td>electricity_usage</td><td>integer</td><td><a data-footnote-ref href="#user-content-fn-1">voer het huidige elektriciteitsverbruik in</a></td></tr><tr><td>build_year</td><td>integer</td><td>bouwjaar van de woning</td></tr><tr><td>energylabel_strict</td><td>integer</td><td>schakel strikt zoeken naar resultaten binnen target_label in met 1, standaard is 0</td></tr><tr><td>fetch_definitive_label</td><td>integer</td><td>activeer het ophalen van definitief label bij EP-online met 1, standaard is 0</td></tr><tr><td>heatpump_insulation_req</td><td>integer</td><td>0 t/m 3 definieerde de minimale isolatie-eis voor advies van een warmtepomp</td></tr><tr><td>exclude_measure</td><td>array</td><td>specifieke maatregelen uitsluiten - zie <a href="maatregelen-uitsluiten">maatregelen uitsluiten</a></td></tr><tr><td>minimum_solar_panels</td><td>integer</td><td>minimaal aantal zonnepanelen mee te nemen in advies indien geadviseerd</td></tr><tr><td>solarpanel_watt_peak</td><td>integer</td><td>Watt piekvermogen van zonnepanelen per vierkante meter</td></tr><tr><td>custom_costs</td><td>array</td><td>aangepaste kosten invoeren - zie <a href="cost-table-input">kostentabel</a></td></tr><tr><td>replace_windowframes</td><td>integer</td><td>activeer extra kosten voor glasgerelateerde codes met 1, zie PDF <a href="cost-table-input">kostentabel</a></td></tr></tbody></table>

{% tabs %}
{% tab title="200: OK Succesvolle reactie" %}

<pre><code>{
	"address": {
		"house_number": 87,
		"post_code": "2771DS",
		"addition": null,
		"street": "Zuidkade",
		"city": "Boskoop",
		"location": {
			"lat": 52.06839381665532,
			"lon": 4.6580852694533394
		}
	},
	"building": {
		"build_year": 1961,
		"inner_surface": 131.0,
		"floor_surface": 97.0,
		"flat_roof_surface": 0,
		"pitched_roof_surface": 124.4,
		"wall_surface": 150.7,
		"glass_living_room_surface": 24.9,
		"glass_bedrooms_surface": 6.9,
		"type": "vrijstaand"
	},
	"label": {
		"current": "G",
		"potential": "A++++"
	},
	"provided_label": {
		"temporary": "F",
		"definitive": "C",
		"definitive_type": null,
		"definitive_validity": null
	},
<strong>	"BENG1": {
</strong>		"current": 165,
		"potential": 139
	},
	"BENG2": {
		"current": 422,
		"potential": -1
	},
	"meta": null,
	"energyindex": {
		"current": null,
		"potential": null
	},
	"ELG": {
		"current": null,
		"potential": null
	},
	"comfortscore": {
		"current": 1,
		"potential": 3
	},
	"CO2": {
		"current": 10632,
		"potential": 2564
	},
	"financial": {
		"total_investment": 67638.64,
		"total_saving": 8119.28,
		"months_to_pay_off": 99,
		"eco_value": null,
		"savings_monthly": 677,
		"energy_cost_monthly": 681,
		"loan": {
			"monthly_payment": 280.0
		}
	},
	"usage": {
		"gas": 6059,
		"energy": 4077,
		"city_heating": 0
	},
	"usage_potential": {
		"gas": 0,
		"energy": 903,
		"city_heating": 0
	},
	"energy_prices": {
		"variable_gas_price": 1.144,
		"variable_electricity_price": 0.293,
		"solarpanel_watt_peak_per_m2": 212
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"after": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 7
			},
			"investment": 2865.38,
			"saving": 1426,
			"co2_reduce": 2223,
			"BENG2": "20.8%",
			"gas_savings": 1205,
			"electricity_savings": 161
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 3
			},
			"investment": 12441.24,
			"saving": 1928,
			"co2_reduce": 3005,
			"BENG2": "28.1%",
			"gas_savings": 1629,
			"electricity_savings": 218
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"bedroom_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "59",
				"value": 59,
				"points": null
			},
			"investment": 21849.7,
			"saving": 3279,
			"co2_reduce": 3705,
			"BENG2": "19%",
			"gas_savings": 0,
			"electricity_savings": 11192
		},
		"instalation": {
			"before": {
				"desc": "HR-combi",
				"value": 4,
				"points": 15
			},
			"after": {
				"desc": "WP bodem combi",
				"value": 7,
				"points": 20
			},
			"investment": 29686.14,
			"saving": 2665,
			"co2_reduce": 4254,
			"BENG2": "64.0%",
			"gas_savings": 6059,
			"electricity_savings": -15438
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "Douche WTW",
				"value": 1,
				"points": null
			},
			"investment": 796.18,
			"saving": 93,
			"co2_reduce": 146,
			"BENG2": "0.4%",
			"gas_savings": 82,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}
</code></pre>

{% endtab %}

{% tab title="400: Bad Request Mislukte reactie" %}

```
{
  "detail": "There was an error parsing the body"
}

{
  "detail": "Address not found in database, combination of zip code and house number"
}

{
  "detail": "There are no measures to suggest for this combination of input."
}

{
  "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": "For a given custom cost make sure the parameter 'value' is provided."
}
{
  "detail": "For a given improvement cost make sure all four parameters: 'material', 'work', 'saving_material' and 'saving _work' are provided."
}
```

{% 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 %}

{% tab title="500: Internal Server Error Service is not available and/or down" %}

```
{
	"message": "Internal server error"
}
```

{% endtab %}

{% tab title="301: Moved Permanently Appartementfout" %}

```
{
    "detail": "Unable to check apartment."
}
```

{% endtab %}

{% tab title="303: See Other huistypefout" %}

```
{ 
  "detail": "House type not found in database. Use house_type parameter instead." 
}
```

{% endtab %}

{% tab title="422: Unprocessable Entity Verkeerd invoerformaat" %}

```
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

## Verstuur objectgegevens om duurzaamheidsmaatregelen per object te ontvangen

<mark style="color:green;">`POST`</mark> `https://api.altum.ai/sustainability/bag`

Vraag een verduurzamingadvies op basis van BagID. Gebruik **bag\_id** als alternatief voor **post\_code, house\_number** en **house\_addition**. Alle andere invoer en uitvoer is gelijk.

#### Headers

| Name                                        | Type   | Description                                                              |
| ------------------------------------------- | ------ | ------------------------------------------------------------------------ |
| Content-Type                                | string | application/json                                                         |
| x-api-key<mark style="color:red;">\*</mark> | string | API-sleutel van Altum. Maak er een via Mopsus(<https://mopsus.altum.ai>) |

#### Request Body

| Name                                      | Type    | Description                                                                                                                                                                              |
| ----------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| bag\_id<mark style="color:red;">\*</mark> | string  | 16 cijfers BAG\_ID                                                                                                                                                                       |
| inner\_surface\_area                      | integer | vierkante meter oppervlakte                                                                                                                                                              |
| build\_year                               | integer | bouwjaar van de woning                                                                                                                                                                   |
| target\_label                             | string  | gewenst doelenergielabel - standaard is energielabel A                                                                                                                                   |
| installation                              | integer | huidige installatie - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                   |
| ventilatiom                               | integer | huidige ventilatie - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                    |
| shower                                    | integer | huidige douche WTW - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                    |
| solar\_panels                             | integer | huidige zonnepanelen in m2 (standaard) of totaal watt-piekvermogen in W (zie watt\_panels) - zie maatregelen                                                                             |
| house\_type                               | integer | huidige woningtype: 1: halfvrijstaand, 2: hoekwoning, 3: rijtjeshuis, 4: vrijstaand huis en 5: appartement\* (\*dienst retourneert geen metingen voor een appartement.)                  |
| lock\_measures                            | array   | sluismaatregelen uitgesloten van berekening                                                                                                                                              |
| watt\_panels                              | integer | neem aan dat de invoer van zonnepanelen in W (0) of m2 (1) is. Standaard = 1                                                                                                             |
| max\_investment                           | integer | maximale investering, gebruik 0 voor onbeperkt                                                                                                                                           |
| electricity\_usage                        | integer | voer het huidige elektriciteitsverbruik in                                                                                                                                               |
| heat\_usage                               | integer | ingangsstroom warmteverbruik                                                                                                                                                             |
| gas\_usage                                | integer | indien gebruikt, wordt het geschatte gasverbruik overschreven                                                                                                                            |
| search\_criteria                          | integer | 0 = Laagste investeringskosten, 1 = Laagste energiekosten, 2 = Hoogste financiële rendement op investering, 3 = Hoogste BARe                                                             |
| heat\_pump\_allowed                       | boolean | wel of niet mogen adviseren om een warmtepomp te implementeren                                                                                                                           |
| replace\_boiler                           | boolean | wel of niet toegestaan om de ketelinstallatie te vervangen                                                                                                                               |
| inhabitants                               | integer | aantal mensen dat in het huis woont                                                                                                                                                      |
| natural\_gas                              | integer | 0 = Aardgas toegestaan, 1 = Aardgas vereist, 2 = Aardgas niet toegestaan                                                                                                                 |
| solar\_panels\_surface                    | integer | 0 = Geen panelen, 1 = Maximaal de helft van de beschikbare ruimte, 2 = Volledig bedekt                                                                                                   |
| heatpump\_insulation\_req                 | integer | 0 t/m 3 definieerde de minimale isolatie-eis voor advies van een warmtepomp                                                                                                              |
| fetch\_definitive\_label                  | integer | activeer het ophalen van definitief label bij EP-online met 1, standaard is 0                                                                                                            |
| energylabel\_strict                       | integer | schakel strikt zoeken naar resultaten binnen target\_label in met 1, standaard is 0                                                                                                      |
| improvement\_costs                        | array   | kosten voor inputverbetering - zie [kostentabel](https://docs.altum.ai/verduurzamen/verduurzaming-api/cost-table-input)                                                                  |
| eco\_delta                                | boolean | schakel het ophalen van ecowaarde uit met 0, standaard is 1                                                                                                                              |
| roof\_insulation                          | integer | huidige dakisolatie - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                   |
| wall\_insulation                          | integer | huidige muurisolatie - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                  |
| floor\_insulation                         | integer | huidige vloerisolatie - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                 |
| living\_room\_windows                     | integer | huidige woonkamerramen - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                                |
| bedroom\_windows                          | integer | huidige slaapkamerramens - zie [maatregelen](https://docs.altum.ai/verduurzamen/verduurzaming-api/measures)                                                                              |
| exclude\_measure                          | array   | 0 t/m 3 definieerde de minimale isolatie-eis voor advies van een warmtepomp - zie [maatregelen uitsluiting](https://docs.altum.ai/verduurzamen/verduurzaming-api/maatregelen-uitsluiten) |
| minimum\_solar\_panels                    | integer | minimaal aantal zonnepanelen mee te nemen in advies indien geadviseerd                                                                                                                   |
| solarpanel\_watt\_peak                    | integer | Wattpiekvermogen van zonnepanelen per vierkante meter                                                                                                                                    |
| custom\_costs                             | array   | aangepaste kosten invoeren - zie [kostentabel](https://docs.altum.ai/verduurzamen/verduurzaming-api/cost-table-input)                                                                    |
| replace\_windowframes                     | integer | activeer extra kosten voor glasgerelateerde codes met 1, zie PDF [kostentabel](https://docs.altum.ai/verduurzamen/verduurzaming-api/cost-table-input)                                    |

{% tabs %}
{% tab title="200: OK Succesvolle reactie" %}

```
{
	"address": {
		"house_number": 87,
		"post_code": "2771DS",
		"addition": null,
		"street": "Zuidkade",
		"city": "Boskoop",
		"location": {
			"lat": 52.06839381665532,
			"lon": 4.6580852694533394
		}
	},
	"building": {
		"build_year": 1961,
		"inner_surface": 131.0,
		"floor_surface": 97.0,
		"flat_roof_surface": 0,
		"pitched_roof_surface": 124.4,
		"wall_surface": 150.7,
		"glass_living_room_surface": 24.9,
		"glass_bedrooms_surface": 6.9,
		"type": "vrijstaand"
	},
	"label": {
		"current": "G",
		"potential": "A++++"
	},
	"provided_label": {
		"temporary": "F",
		"definitive": "C",
		"definitive_type": null,
		"definitive_validity": null
	},
	"BENG2": {
		"current": 422,
		"potential": -1
	},
	"meta": null,
	"energyindex": {
		"current": null,
		"potential": null
	},
	"ELG": {
		"current": null,
		"potential": null
	},
	"comfortscore": {
		"current": 1,
		"potential": 3
	},
	"CO2": {
		"current": 10632,
		"potential": 2564
	},
	"financial": {
		"total_investment": 67638.64,
		"total_saving": 8119.28,
		"months_to_pay_off": 99,
		"eco_value": null,
		"savings_monthly": 677,
		"energy_cost_monthly": 681,
		"loan": {
			"monthly_payment": 280.0
		}
	},
	"usage": {
		"gas": 6059,
		"energy": 4077,
		"city_heating": 0
	},
	"usage_potential": {
		"gas": 0,
		"energy": 903,
		"city_heating": 0
	},
	"energy_prices": {
		"variable_gas_price": 1.144,
		"variable_electricity_price": 0.293,
		"solarpanel_watt_peak_per_m2": 212
	},
	"measures": {
		"wall_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"after": {
				"desc": "Geen",
				"value": 0,
				"points": 2
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"floor_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 7
			},
			"investment": 2865.38,
			"saving": 1426,
			"co2_reduce": 2223,
			"BENG2": "20.8%",
			"gas_savings": 1205,
			"electricity_savings": 161
		},
		"roof_insulation": {
			"before": {
				"desc": "Geen",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Goed",
				"value": 2,
				"points": 3
			},
			"investment": 12441.24,
			"saving": 1928,
			"co2_reduce": 3005,
			"BENG2": "28.1%",
			"gas_savings": 1629,
			"electricity_savings": 218
		},
		"living_room_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": 1
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"bedroom_windows": {
			"before": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"after": {
				"desc": "Dubbel glas",
				"value": 1,
				"points": null
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"ventilation": {
			"before": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"after": {
				"desc": "Natuurlijk",
				"value": 0,
				"points": 0
			},
			"investment": 0.0,
			"saving": 0,
			"co2_reduce": 0,
			"BENG2": "0%",
			"gas_savings": 0,
			"electricity_savings": 0
		},
		"solar_panels": {
			"before": {
				"desc": "0",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "59",
				"value": 59,
				"points": null
			},
			"investment": 21849.7,
			"saving": 3279,
			"co2_reduce": 3705,
			"BENG2": "19%",
			"gas_savings": 0,
			"electricity_savings": 11192
		},
		"instalation": {
			"before": {
				"desc": "HR-combi",
				"value": 4,
				"points": 15
			},
			"after": {
				"desc": "WP bodem combi",
				"value": 7,
				"points": 20
			},
			"investment": 29686.14,
			"saving": 2665,
			"co2_reduce": 4254,
			"BENG2": "64.0%",
			"gas_savings": 6059,
			"electricity_savings": -15438
		},
		"shower": {
			"before": {
				"desc": "Geen Douche WTW",
				"value": 0,
				"points": null
			},
			"after": {
				"desc": "Douche WTW",
				"value": 1,
				"points": null
			},
			"investment": 796.18,
			"saving": 93,
			"co2_reduce": 146,
			"BENG2": "0.4%",
			"gas_savings": 82,
			"electricity_savings": 0
		}
	},
	"response_meta": null
}
```

{% endtab %}

{% tab title="400: Bad Request Mislukte reactie" %}

```
{
  "detail": "There was an error parsing the body"
}

{
  "detail": "Address not found in database, combination of zip code and house number"
}

{
  "detail": "There are no measures to suggest for this combination of input."
}

{
  "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."
}
```

{% 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="422: Unprocessable Entity Verkeerd invoerformaat" %}

```
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```

{% endtab %}

{% tab title="500: Internal Server Error Service is niet beschikbaar en/of niet beschikbaar" %}

```
{
	"message": "Internal server error"
}
```

{% endtab %}

{% tab title="403: Forbidden Verboden" %}

```
{
	"message": "Missing Authentication Token"
}
```

{% endtab %}

{% tab title="301: Moved Permanently Appartementfout" %}

```
{
    "detail": "Unable to check apartment."
}
```

{% endtab %}

{% tab title="303: See Other huistypefout" %}

```
{ 
  "detail": "House type not found in database. Use house_type parameter instead." 
}
```

{% endtab %}
{% endtabs %}

## Request body

#### Voorbeeld verzoeken

```
{
    "data": {
    "post_code": "2771DS",
    "house_number": "87",
    "target_label": "A++++",
    "eco_delta": 0
	}
}
```

```
{
    "data": {
    "bag_id": "0637010000264937",
    "target_label": "A++++",
    "eco_delta": 0
	}
}
```

[^1]: eigen elektriciteitsverbruik is het netto jaarlijkse elektriciteitsverbruik dat resulteert na de aftrek van de totale jaarlijkse eigen opwekking door zonnepanelen. Het is het jaarlijkse verbruik na saldering van de opwekking van aanwezige zonnepanelen.