# Woonlasten API

## GET /local-tax-energy-expenses

> Indicates the housing costs that apply per municipality.

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"servers":[{"url":"https://api.matrixian.com/v1","description":"Matrixian API"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"{{API_KEY}}"}},"schemas":{"AddressInput":{"properties":{"postalCode":{"type":"string","title":"Postalcode","description":"Postal code"},"houseNumber":{"type":"integer","title":"Housenumber","description":"House number"},"houseLetter":{"title":"Houseletter","description":"House letter","type":"string","nullable":true},"houseNumberExt":{"title":"Housenumberext","description":"House number extension","type":"string","nullable":true}},"type":"object","required":["postalCode","houseNumber"],"title":"AddressInput"},"LocalTaxEnergyResponse":{"properties":{"inputPostcode":{"type":"string","title":"Inputpostcode","description":"Postal code"},"inputHouseNumber":{"type":"integer","title":"Inputhousenumber","description":"House number"},"inputHouseNumberExt":{"title":"Inputhousenumberext","description":"House number extension","type":"string","nullable":true},"municipalTaxes":{"description":"Object containing municipal taxes","allOf":[{"$ref":"#/components/schemas/MunicipalTaxes"}]},"municipalityCode":{"type":"string","title":"Municipalitycode","description":"Municipality code"},"utilities":{"description":"Object containing utility usage","allOf":[{"$ref":"#/components/schemas/Utilities"}]},"municipalityName":{"type":"string","title":"Municipalityname","description":"Municipality name"}},"type":"object","required":["inputPostcode","inputHouseNumber","municipalTaxes","municipalityCode","utilities","municipalityName"],"title":"LocalTaxEnergyResponse"},"MunicipalTaxes":{"properties":{"fees":{"description":"Other fees","allOf":[{"$ref":"#/components/schemas/Fees"}]},"touristTax":{"description":"Tourist Tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"wasteCollectionCharge":{"description":"Waste collection charge","allOf":[{"$ref":"#/components/schemas/Households"}]},"environmentalPermit":{"description":"Environmental permit","allOf":[{"$ref":"#/components/schemas/EnvironmentalPermit"}]},"sewerCharge":{"description":"Sewer charge","allOf":[{"$ref":"#/components/schemas/SewerCharge"}]},"parkingTax":{"default":null,"description":"Parking tax","title":"Parkingtax","type":"integer","nullable":true},"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/HousingCosts"}]},"propertyTax":{"description":"Property tax","allOf":[{"$ref":"#/components/schemas/PropertyTax"}]},"dogTax":{"description":"Dog tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["fees","touristTax","wasteCollectionCharge","environmentalPermit","sewerCharge","housingCosts","propertyTax","dogTax"],"title":"MunicipalTaxes","type":"object"},"Fees":{"properties":{"driversLicence":{"description":"Costs of a driver's license","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"passport":{"description":"Costs of a passport","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"identityCard":{"description":"Costs of an ID card","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"extractMunicipalPersonalRecordsDatabase":{"description":"Costs of an official BRP excerpt","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["driversLicence","passport","identityCard","extractMunicipalPersonalRecordsDatabase"],"title":"Fees","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"},"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EnvironmentalPermit":{"properties":{"houseExtension":{"description":"Permit costs for a house extension","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"newConstruction":{"description":"Permit costs for new construction","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"dormer":{"description":"Permit costs for a dormer","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["houseExtension","newConstruction","dormer"],"title":"EnvironmentalPermit","type":"object"},"SewerCharge":{"properties":{"households":{"description":"Taxes paid for sewage processing for households","allOf":[{"$ref":"#/components/schemas/Households"}]},"businesses":{"description":"Taxes paid for sewage processing for businesses","allOf":[{"$ref":"#/components/schemas/Businesses"}]}},"required":["households","businesses"],"title":"SewerCharge","type":"object"},"Businesses":{"properties":{"waterConsumptionInCubicMeter":{"additionalProperties":{"$ref":"#/components/schemas/EuroObject"},"description":"Water consumption (in m³) by businesses","title":"Waterconsumptionincubicmeter","type":"object"}},"required":["waterConsumptionInCubicMeter"],"title":"Businesses","type":"object"},"HousingCosts":{"properties":{"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/Households"}]},"taxCredit":{"description":"Tax credit","allOf":[{"$ref":"#/components/schemas/TaxCredit"}]}},"required":["housingCosts","taxCredit"],"title":"HousingCosts","type":"object"},"TaxCredit":{"properties":{"multiPersonHousehold":{"description":"Tax credit for multi person households","title":"Multipersonhousehold","type":"number"},"singlePersonHousehold":{"description":"Tax credit for single person households","title":"Singlepersonhousehold","type":"number"}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"TaxCredit","type":"object"},"PropertyTax":{"properties":{"rate":{"description":"Rate of property tax","allOf":[{"$ref":"#/components/schemas/Rate"}]},"residentialAverage":{"description":"Residential Average of property tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["rate","residentialAverage"],"title":"PropertyTax","type":"object"},"Rate":{"properties":{"residential":{"description":"Taxes paid on residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]},"nonresidential":{"description":"Taxes paid on non-residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]}},"required":["residential","nonresidential"],"title":"Rate","type":"object"},"PercentageObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"percentage":{"description":"Rate (%)","title":"Percentage","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","percentage","comment"],"title":"PercentageObject","type":"object"},"Utilities":{"properties":{"naturalGasUsageInCubicMeter":{"description":"Object containing average natural gas usage (in m³) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"elektricityUsageKwh":{"description":"Object containing average electricity usage (in kWh) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"percentageDistrictHeating":{"description":"Object containing percentage of district heating for different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]}},"required":["naturalGasUsageInCubicMeter","elektricityUsageKwh","percentageDistrictHeating"],"title":"Utilities","type":"object"},"EnergyUsage":{"properties":{"apartment":{"description":"Average energy usage of apartments","title":"Apartment","type":"number","nullable":true},"average":{"description":"Average energy usage of all house types","title":"Average","type":"number","nullable":true},"cornerHouse":{"description":"Average energy usage of corner house","title":"Cornerhouse","type":"number","nullable":true},"detachedHouse":{"description":"Average energy usage of detached house","title":"Detachedhouse","type":"number","nullable":true},"ownedHomes":{"description":"Average energy usage of owned homes","title":"Ownedhomes","type":"number","nullable":true},"rentalHomes":{"description":"Average energy usage of rental homes","title":"Rentalhomes","type":"number","nullable":true},"semidetachedHouse":{"description":"Average energy usage of semidetached houses","title":"Semidetachedhouse","type":"number","nullable":true},"terracedHouse":{"description":"Average energy usage of terraced houses","title":"Terracedhouse","type":"number","nullable":true}},"required":["apartment","average","cornerHouse","detachedHouse","ownedHomes","rentalHomes","semidetachedHouse","terracedHouse"],"title":"EnergyUsage","type":"object"},"ErrorObject":{"properties":{"code":{"type":"integer","title":"Code"},"message":{"type":"string","title":"Message"},"errors":{"items":{"$ref":"#/components/schemas/ErrorDetail"},"type":"array","title":"Errors"}},"type":"object","required":["code","message","errors"],"title":"ErrorObject"},"ErrorDetail":{"properties":{"reason":{"type":"string","title":"Reason"},"message":{"type":"string","title":"Message"}},"type":"object","required":["reason","message"],"title":"ErrorDetail"}}},"paths":{"/local-tax-energy-expenses":{"get":{"description":"Indicates the housing costs that apply per municipality.","operationId":"MunicipalityLivingCosts","parameters":[{"description":"Postal code","required":true,"style":"form","explode":true,"schema":{"type":"string"},"name":"postalCode","in":"query"},{"description":"House number","required":true,"style":"form","explode":true,"schema":{"type":"integer"},"name":"houseNumber","in":"query"},{"description":"House letter","required":false,"style":"form","explode":true,"schema":{"type":"string"},"name":"houseLetter","in":"query"},{"description":"House number extension","required":false,"style":"form","explode":true,"schema":{"type":"string"},"name":"houseNumberExt","in":"query"}],"responses":{"200":{"description":"LocalTaxEnergyResponse","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/AddressInput"},"data":{"$ref":"#/components/schemas/LocalTaxEnergyResponse"},"error":{"additionalProperties":{"type":"string"},"type":"object"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["data","status"]}}}},"400":{"description":"HTTP 400","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/AddressInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"401":{"description":"HTTP 401","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/AddressInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"403":{"description":"HTTP 403","content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object","required":["message"]}}}},"404":{"description":"HTTP 404","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/AddressInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}},"500":{"description":"HTTP 500","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","nullable":true},"params":{"$ref":"#/components/schemas/AddressInput"},"data":{"additionalProperties":{"type":"string"},"type":"object"},"error":{"$ref":"#/components/schemas/ErrorObject"},"meta":{"additionalProperties":{"type":"string"},"type":"object","nullable":true},"status":{"type":"string"}},"type":"object","required":["error","status"]}}}}}}}}}
```

## The LocalTaxEnergyResponse object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"LocalTaxEnergyResponse":{"properties":{"inputPostcode":{"type":"string","title":"Inputpostcode","description":"Postal code"},"inputHouseNumber":{"type":"integer","title":"Inputhousenumber","description":"House number"},"inputHouseNumberExt":{"title":"Inputhousenumberext","description":"House number extension","type":"string","nullable":true},"municipalTaxes":{"description":"Object containing municipal taxes","allOf":[{"$ref":"#/components/schemas/MunicipalTaxes"}]},"municipalityCode":{"type":"string","title":"Municipalitycode","description":"Municipality code"},"utilities":{"description":"Object containing utility usage","allOf":[{"$ref":"#/components/schemas/Utilities"}]},"municipalityName":{"type":"string","title":"Municipalityname","description":"Municipality name"}},"type":"object","required":["inputPostcode","inputHouseNumber","municipalTaxes","municipalityCode","utilities","municipalityName"],"title":"LocalTaxEnergyResponse"},"MunicipalTaxes":{"properties":{"fees":{"description":"Other fees","allOf":[{"$ref":"#/components/schemas/Fees"}]},"touristTax":{"description":"Tourist Tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"wasteCollectionCharge":{"description":"Waste collection charge","allOf":[{"$ref":"#/components/schemas/Households"}]},"environmentalPermit":{"description":"Environmental permit","allOf":[{"$ref":"#/components/schemas/EnvironmentalPermit"}]},"sewerCharge":{"description":"Sewer charge","allOf":[{"$ref":"#/components/schemas/SewerCharge"}]},"parkingTax":{"default":null,"description":"Parking tax","title":"Parkingtax","type":"integer","nullable":true},"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/HousingCosts"}]},"propertyTax":{"description":"Property tax","allOf":[{"$ref":"#/components/schemas/PropertyTax"}]},"dogTax":{"description":"Dog tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["fees","touristTax","wasteCollectionCharge","environmentalPermit","sewerCharge","housingCosts","propertyTax","dogTax"],"title":"MunicipalTaxes","type":"object"},"Fees":{"properties":{"driversLicence":{"description":"Costs of a driver's license","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"passport":{"description":"Costs of a passport","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"identityCard":{"description":"Costs of an ID card","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"extractMunicipalPersonalRecordsDatabase":{"description":"Costs of an official BRP excerpt","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["driversLicence","passport","identityCard","extractMunicipalPersonalRecordsDatabase"],"title":"Fees","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"},"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EnvironmentalPermit":{"properties":{"houseExtension":{"description":"Permit costs for a house extension","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"newConstruction":{"description":"Permit costs for new construction","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"dormer":{"description":"Permit costs for a dormer","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["houseExtension","newConstruction","dormer"],"title":"EnvironmentalPermit","type":"object"},"SewerCharge":{"properties":{"households":{"description":"Taxes paid for sewage processing for households","allOf":[{"$ref":"#/components/schemas/Households"}]},"businesses":{"description":"Taxes paid for sewage processing for businesses","allOf":[{"$ref":"#/components/schemas/Businesses"}]}},"required":["households","businesses"],"title":"SewerCharge","type":"object"},"Businesses":{"properties":{"waterConsumptionInCubicMeter":{"additionalProperties":{"$ref":"#/components/schemas/EuroObject"},"description":"Water consumption (in m³) by businesses","title":"Waterconsumptionincubicmeter","type":"object"}},"required":["waterConsumptionInCubicMeter"],"title":"Businesses","type":"object"},"HousingCosts":{"properties":{"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/Households"}]},"taxCredit":{"description":"Tax credit","allOf":[{"$ref":"#/components/schemas/TaxCredit"}]}},"required":["housingCosts","taxCredit"],"title":"HousingCosts","type":"object"},"TaxCredit":{"properties":{"multiPersonHousehold":{"description":"Tax credit for multi person households","title":"Multipersonhousehold","type":"number"},"singlePersonHousehold":{"description":"Tax credit for single person households","title":"Singlepersonhousehold","type":"number"}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"TaxCredit","type":"object"},"PropertyTax":{"properties":{"rate":{"description":"Rate of property tax","allOf":[{"$ref":"#/components/schemas/Rate"}]},"residentialAverage":{"description":"Residential Average of property tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["rate","residentialAverage"],"title":"PropertyTax","type":"object"},"Rate":{"properties":{"residential":{"description":"Taxes paid on residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]},"nonresidential":{"description":"Taxes paid on non-residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]}},"required":["residential","nonresidential"],"title":"Rate","type":"object"},"PercentageObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"percentage":{"description":"Rate (%)","title":"Percentage","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","percentage","comment"],"title":"PercentageObject","type":"object"},"Utilities":{"properties":{"naturalGasUsageInCubicMeter":{"description":"Object containing average natural gas usage (in m³) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"elektricityUsageKwh":{"description":"Object containing average electricity usage (in kWh) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"percentageDistrictHeating":{"description":"Object containing percentage of district heating for different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]}},"required":["naturalGasUsageInCubicMeter","elektricityUsageKwh","percentageDistrictHeating"],"title":"Utilities","type":"object"},"EnergyUsage":{"properties":{"apartment":{"description":"Average energy usage of apartments","title":"Apartment","type":"number","nullable":true},"average":{"description":"Average energy usage of all house types","title":"Average","type":"number","nullable":true},"cornerHouse":{"description":"Average energy usage of corner house","title":"Cornerhouse","type":"number","nullable":true},"detachedHouse":{"description":"Average energy usage of detached house","title":"Detachedhouse","type":"number","nullable":true},"ownedHomes":{"description":"Average energy usage of owned homes","title":"Ownedhomes","type":"number","nullable":true},"rentalHomes":{"description":"Average energy usage of rental homes","title":"Rentalhomes","type":"number","nullable":true},"semidetachedHouse":{"description":"Average energy usage of semidetached houses","title":"Semidetachedhouse","type":"number","nullable":true},"terracedHouse":{"description":"Average energy usage of terraced houses","title":"Terracedhouse","type":"number","nullable":true}},"required":["apartment","average","cornerHouse","detachedHouse","ownedHomes","rentalHomes","semidetachedHouse","terracedHouse"],"title":"EnergyUsage","type":"object"}}}}
```

## The MunicipalTaxes object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"MunicipalTaxes":{"properties":{"fees":{"description":"Other fees","allOf":[{"$ref":"#/components/schemas/Fees"}]},"touristTax":{"description":"Tourist Tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"wasteCollectionCharge":{"description":"Waste collection charge","allOf":[{"$ref":"#/components/schemas/Households"}]},"environmentalPermit":{"description":"Environmental permit","allOf":[{"$ref":"#/components/schemas/EnvironmentalPermit"}]},"sewerCharge":{"description":"Sewer charge","allOf":[{"$ref":"#/components/schemas/SewerCharge"}]},"parkingTax":{"default":null,"description":"Parking tax","title":"Parkingtax","type":"integer","nullable":true},"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/HousingCosts"}]},"propertyTax":{"description":"Property tax","allOf":[{"$ref":"#/components/schemas/PropertyTax"}]},"dogTax":{"description":"Dog tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["fees","touristTax","wasteCollectionCharge","environmentalPermit","sewerCharge","housingCosts","propertyTax","dogTax"],"title":"MunicipalTaxes","type":"object"},"Fees":{"properties":{"driversLicence":{"description":"Costs of a driver's license","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"passport":{"description":"Costs of a passport","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"identityCard":{"description":"Costs of an ID card","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"extractMunicipalPersonalRecordsDatabase":{"description":"Costs of an official BRP excerpt","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["driversLicence","passport","identityCard","extractMunicipalPersonalRecordsDatabase"],"title":"Fees","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"},"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EnvironmentalPermit":{"properties":{"houseExtension":{"description":"Permit costs for a house extension","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"newConstruction":{"description":"Permit costs for new construction","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"dormer":{"description":"Permit costs for a dormer","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["houseExtension","newConstruction","dormer"],"title":"EnvironmentalPermit","type":"object"},"SewerCharge":{"properties":{"households":{"description":"Taxes paid for sewage processing for households","allOf":[{"$ref":"#/components/schemas/Households"}]},"businesses":{"description":"Taxes paid for sewage processing for businesses","allOf":[{"$ref":"#/components/schemas/Businesses"}]}},"required":["households","businesses"],"title":"SewerCharge","type":"object"},"Businesses":{"properties":{"waterConsumptionInCubicMeter":{"additionalProperties":{"$ref":"#/components/schemas/EuroObject"},"description":"Water consumption (in m³) by businesses","title":"Waterconsumptionincubicmeter","type":"object"}},"required":["waterConsumptionInCubicMeter"],"title":"Businesses","type":"object"},"HousingCosts":{"properties":{"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/Households"}]},"taxCredit":{"description":"Tax credit","allOf":[{"$ref":"#/components/schemas/TaxCredit"}]}},"required":["housingCosts","taxCredit"],"title":"HousingCosts","type":"object"},"TaxCredit":{"properties":{"multiPersonHousehold":{"description":"Tax credit for multi person households","title":"Multipersonhousehold","type":"number"},"singlePersonHousehold":{"description":"Tax credit for single person households","title":"Singlepersonhousehold","type":"number"}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"TaxCredit","type":"object"},"PropertyTax":{"properties":{"rate":{"description":"Rate of property tax","allOf":[{"$ref":"#/components/schemas/Rate"}]},"residentialAverage":{"description":"Residential Average of property tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["rate","residentialAverage"],"title":"PropertyTax","type":"object"},"Rate":{"properties":{"residential":{"description":"Taxes paid on residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]},"nonresidential":{"description":"Taxes paid on non-residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]}},"required":["residential","nonresidential"],"title":"Rate","type":"object"},"PercentageObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"percentage":{"description":"Rate (%)","title":"Percentage","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","percentage","comment"],"title":"PercentageObject","type":"object"}}}}
```

## The Utilities object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"Utilities":{"properties":{"naturalGasUsageInCubicMeter":{"description":"Object containing average natural gas usage (in m³) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"elektricityUsageKwh":{"description":"Object containing average electricity usage (in kWh) of different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]},"percentageDistrictHeating":{"description":"Object containing percentage of district heating for different house types","allOf":[{"$ref":"#/components/schemas/EnergyUsage"}]}},"required":["naturalGasUsageInCubicMeter","elektricityUsageKwh","percentageDistrictHeating"],"title":"Utilities","type":"object"},"EnergyUsage":{"properties":{"apartment":{"description":"Average energy usage of apartments","title":"Apartment","type":"number","nullable":true},"average":{"description":"Average energy usage of all house types","title":"Average","type":"number","nullable":true},"cornerHouse":{"description":"Average energy usage of corner house","title":"Cornerhouse","type":"number","nullable":true},"detachedHouse":{"description":"Average energy usage of detached house","title":"Detachedhouse","type":"number","nullable":true},"ownedHomes":{"description":"Average energy usage of owned homes","title":"Ownedhomes","type":"number","nullable":true},"rentalHomes":{"description":"Average energy usage of rental homes","title":"Rentalhomes","type":"number","nullable":true},"semidetachedHouse":{"description":"Average energy usage of semidetached houses","title":"Semidetachedhouse","type":"number","nullable":true},"terracedHouse":{"description":"Average energy usage of terraced houses","title":"Terracedhouse","type":"number","nullable":true}},"required":["apartment","average","cornerHouse","detachedHouse","ownedHomes","rentalHomes","semidetachedHouse","terracedHouse"],"title":"EnergyUsage","type":"object"}}}}
```

## The Fees object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"Fees":{"properties":{"driversLicence":{"description":"Costs of a driver's license","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"passport":{"description":"Costs of a passport","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"identityCard":{"description":"Costs of an ID card","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"extractMunicipalPersonalRecordsDatabase":{"description":"Costs of an official BRP excerpt","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["driversLicence","passport","identityCard","extractMunicipalPersonalRecordsDatabase"],"title":"Fees","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The EuroObject object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The EnvironmentalPermit object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"EnvironmentalPermit":{"properties":{"houseExtension":{"description":"Permit costs for a house extension","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"newConstruction":{"description":"Permit costs for new construction","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"dormer":{"description":"Permit costs for a dormer","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["houseExtension","newConstruction","dormer"],"title":"EnvironmentalPermit","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The SewerCharge object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"SewerCharge":{"properties":{"households":{"description":"Taxes paid for sewage processing for households","allOf":[{"$ref":"#/components/schemas/Households"}]},"businesses":{"description":"Taxes paid for sewage processing for businesses","allOf":[{"$ref":"#/components/schemas/Businesses"}]}},"required":["households","businesses"],"title":"SewerCharge","type":"object"},"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"},"Businesses":{"properties":{"waterConsumptionInCubicMeter":{"additionalProperties":{"$ref":"#/components/schemas/EuroObject"},"description":"Water consumption (in m³) by businesses","title":"Waterconsumptionincubicmeter","type":"object"}},"required":["waterConsumptionInCubicMeter"],"title":"Businesses","type":"object"}}}}
```

## The HousingCosts object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"HousingCosts":{"properties":{"housingCosts":{"description":"Housing costs","allOf":[{"$ref":"#/components/schemas/Households"}]},"taxCredit":{"description":"Tax credit","allOf":[{"$ref":"#/components/schemas/TaxCredit"}]}},"required":["housingCosts","taxCredit"],"title":"HousingCosts","type":"object"},"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"},"TaxCredit":{"properties":{"multiPersonHousehold":{"description":"Tax credit for multi person households","title":"Multipersonhousehold","type":"number"},"singlePersonHousehold":{"description":"Tax credit for single person households","title":"Singlepersonhousehold","type":"number"}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"TaxCredit","type":"object"}}}}
```

## The PropertyTax object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"PropertyTax":{"properties":{"rate":{"description":"Rate of property tax","allOf":[{"$ref":"#/components/schemas/Rate"}]},"residentialAverage":{"description":"Residential Average of property tax","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["rate","residentialAverage"],"title":"PropertyTax","type":"object"},"Rate":{"properties":{"residential":{"description":"Taxes paid on residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]},"nonresidential":{"description":"Taxes paid on non-residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]}},"required":["residential","nonresidential"],"title":"Rate","type":"object"},"PercentageObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"percentage":{"description":"Rate (%)","title":"Percentage","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","percentage","comment"],"title":"PercentageObject","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The EnergyUsage object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"EnergyUsage":{"properties":{"apartment":{"description":"Average energy usage of apartments","title":"Apartment","type":"number","nullable":true},"average":{"description":"Average energy usage of all house types","title":"Average","type":"number","nullable":true},"cornerHouse":{"description":"Average energy usage of corner house","title":"Cornerhouse","type":"number","nullable":true},"detachedHouse":{"description":"Average energy usage of detached house","title":"Detachedhouse","type":"number","nullable":true},"ownedHomes":{"description":"Average energy usage of owned homes","title":"Ownedhomes","type":"number","nullable":true},"rentalHomes":{"description":"Average energy usage of rental homes","title":"Rentalhomes","type":"number","nullable":true},"semidetachedHouse":{"description":"Average energy usage of semidetached houses","title":"Semidetachedhouse","type":"number","nullable":true},"terracedHouse":{"description":"Average energy usage of terraced houses","title":"Terracedhouse","type":"number","nullable":true}},"required":["apartment","average","cornerHouse","detachedHouse","ownedHomes","rentalHomes","semidetachedHouse","terracedHouse"],"title":"EnergyUsage","type":"object"}}}}
```

## The Households object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"Households":{"properties":{"multiPersonHousehold":{"description":"Taxes paid for a multi person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]},"singlePersonHousehold":{"description":"Taxes paid for a single person household","allOf":[{"$ref":"#/components/schemas/EuroObject"}]}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"Households","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The Businesses object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"Businesses":{"properties":{"waterConsumptionInCubicMeter":{"additionalProperties":{"$ref":"#/components/schemas/EuroObject"},"description":"Water consumption (in m³) by businesses","title":"Waterconsumptionincubicmeter","type":"object"}},"required":["waterConsumptionInCubicMeter"],"title":"Businesses","type":"object"},"EuroObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"euro":{"description":"Price or amount in EUR (€)","title":"Euro","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","euro","comment"],"title":"EuroObject","type":"object"}}}}
```

## The TaxCredit object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"TaxCredit":{"properties":{"multiPersonHousehold":{"description":"Tax credit for multi person households","title":"Multipersonhousehold","type":"number"},"singlePersonHousehold":{"description":"Tax credit for single person households","title":"Singlepersonhousehold","type":"number"}},"required":["multiPersonHousehold","singlePersonHousehold"],"title":"TaxCredit","type":"object"}}}}
```

## The Rate object

```json
{"openapi":"3.0.3","info":{"title":"Matrixian API","version":"1.0.0"},"components":{"schemas":{"Rate":{"properties":{"residential":{"description":"Taxes paid on residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]},"nonresidential":{"description":"Taxes paid on non-residential real estate in proportion to real estate value.","allOf":[{"$ref":"#/components/schemas/PercentageObject"}]}},"required":["residential","nonresidential"],"title":"Rate","type":"object"},"PercentageObject":{"properties":{"mutation":{"description":"Mutation as compared to last year","title":"Mutation","type":"number","nullable":true},"percentage":{"description":"Rate (%)","title":"Percentage","type":"number","nullable":true},"comment":{"description":"Comment","title":"Comment","type":"string","nullable":true}},"required":["mutation","percentage","comment"],"title":"PercentageObject","type":"object"}}}}
```


---

# 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:

```
GET https://docs.matrixian.com/woningdata/woonlasten-api.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.