{"openapi":"3.1.0","info":{"title":"enfy API","version":"1.6.1","summary":"Energiekosten berekenen en energieprijzen opvragen voor Nederland, met links naar onze pagina's.","description":"Openbare, gratis API van enfy. Alle kosten komen uit dezelfde rekenkern als de vergelijker op https://enfy.nl/; alleen gepubliceerde, gecontroleerde tarieven tellen mee.\n\n**Bedragen**: totalen in hele centen (`*_cents`), eenheidsprijzen in micro-euro (`*_micro`, € × 1.000.000), met de tekst ernaast onder de naam zonder achtervoegsel. Incl. 21% btw, tenzij de naam `excl_vat` bevat.\n\n**Volgorde**: alleen op kosten in het eerste jaar, zonder welkomstbonus. Een betaalde positie staat nooit in die volgorde maar apart in `paid_positions`, met het label \"Betaalde positie\".\n\n**Bronvermelding**: toon `meta.attribution` en link naar `meta.url` (of per aanbieding `url`). Links gaan altijd naar onze pagina's.\n\n**Privacy**: geen cookies, geen huisnummer, geen sleutel nodig. De limiet per minuut telt onder een versleutelde, dagelijks wisselende code van het IP-adres die na een minuut vervalt; het IP-adres zelf bewaren we niet.\n\n**API-sleutel (optioneel)**: met een sleutel in de header `X-Api-Key` gelden de limieten van de sleutel, geteld per sleutel in plaats van per IP. Zonder sleutel werkt alles anoniem. Een ongeldige, ingetrokken of verlopen sleutel geeft 401 `invalid_api_key` (nooit stil anoniem); een ontbrekende scope 403 `insufficient_scope`; een sleutel in de URL 400 `api_key_in_query`. Sleutels zijn voor gebruik op een server, niet in een browser. Scopes: `public` (alle endpoints en /mcp), `compare` (eigen, hogere limiet voor de rekenende endpoints), `ops:read` (alleen intern).\n\n**Advies contractvorm** (`/advies`, ook als `contract_advice` in `/dynamisch-of-vast` en de MCP-tool `dynamisch_of_vast`): een vuistregel op basis van het prijsniveau nu tegenover de maanden sinds 2018-01, geen voorspelling en geen persoonlijk advies. Geef het advies altijd door met `disclaimer`.\n\n**MCP**: dezelfde gegevens als remote MCP-server (streamable HTTP) op https://enfy.nl/mcp. Alleen daar: `thuisbatterij_berekenen` (loont een thuisbatterij?). Zonder `installatie` (of met `installatie=advies`) rekent die een stekkerbatterij, een vaste thuisbatterij en losse componenten door en geeft `recommendation` de aanbevolen soort met reden en de cijfers per soort; met `vast`, `stekker` of `componenten` rekent hij met die soort en noemt `recommendation.sooner` een soort die duidelijk sneller terugverdiend is.","contact":{"name":"enfy","url":"https://enfy.nl/contact","email":"info@enfy.nl"},"termsOfService":"https://enfy.nl/api#gebruik"},"externalDocs":{"description":"Uitleg en voorbeelden","url":"https://enfy.nl/api"},"servers":[{"url":"https://enfy.nl/api/v1"}],"tags":[{"name":"Berekenen","description":"Kosten voor een huishouden met de rekenkern"},{"name":"Leveranciers","description":"Leveranciers, dekking en tarieven"},{"name":"Marktprijzen","description":"Day-ahead-stroom en gasdagprijs"},{"name":"Belasting","description":"Energiebelasting"},{"name":"Historie","description":"Prijzen en belasting door de jaren"},{"name":"Advies","description":"Vuistregel voor de contractvorm op basis van het prijsniveau (geen voorspelling)"}],"paths":{"/vergelijk":{"get":{"tags":["Berekenen"],"operationId":"vergelijk","summary":"Goedkoopste aanbiedingen voor een huishouden","description":"Top N aanbiedingen (vast/variabel op kosten, dynamisch apart als schatting) met maandbedrag, kosten eerste jaar, opbouw per kostenpost, aannames en een link naar onze resultaatpagina met dezelfde invoer. Zonder verbruik rekenen we met het gemiddelde huishouden (2580 kWh, 790 m³, CBS 2025). Limiet: 30 verzoeken per minuut.","parameters":[{"name":"kwh","in":"query","required":false,"description":"Stroomverbruik per jaar (enkeltarief), kWh.","schema":{"type":"integer","minimum":0,"maximum":100000},"example":2500},{"name":"kwh_normaal","in":"query","required":false,"description":"Verbruik normaaltarief per jaar, kWh (samen met kwh_dal; gaat voor kwh).","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"kwh_dal","in":"query","required":false,"description":"Verbruik daltarief per jaar, kWh.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"m3","in":"query","required":false,"description":"Gasverbruik per jaar, m³.","schema":{"type":"integer","minimum":0,"maximum":20000},"example":1200},{"name":"geen_gas","in":"query","required":false,"description":"Geen gasaansluiting.","schema":{"type":"boolean"}},{"name":"teruglevering","in":"query","required":false,"description":"Teruglevering aan het net per jaar (zonnepanelen), kWh. Gaat voor zonnepanelen_wp.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"zonnepanelen_wp","in":"query","required":false,"description":"Alleen als de teruglevering niet bekend is: vermogen van alle zonnepanelen samen, Wp. kwh (of kwh_normaal + kwh_dal) is dan het totale eigen verbruik; de rekenkern schat per uur (weer van de afgelopen 12 maanden, ligging onbekend) de afname van het net en de teruglevering. Zie household.solar_estimate en assumptions; de url rekent met dezelfde afname en teruglevering.","schema":{"type":"integer","minimum":0,"maximum":80000},"example":4300},{"name":"aantal_panelen","in":"query","required":false,"description":"Of: aantal zonnepanelen (met wp_per_paneel), in plaats van zonnepanelen_wp.","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"wp_per_paneel","in":"query","required":false,"description":"Vermogen per paneel, Wp (standaard het paneel waarmee Milieu Centraal rekent).","schema":{"type":"integer","minimum":100,"maximum":800}},{"name":"aansluiting","in":"query","required":false,"description":"Aansluitwaarde van de stroomaansluiting (standaard 3x25). Een grotere aansluiting heeft hogere netbeheerkosten. Ook \"3x35A\" of \"e_3x35\" mag.","schema":{"type":"string","enum":["1x6","1x10","3x25","3x35","3x50","3x63","3x80"]}},{"name":"netbeheerder","in":"query","required":false,"description":"Netbeheerder voor stroom, en ook voor gas als netbeheerder_gas ontbreekt (gaat voor postcode). Zonder netbeheerder en postcode: gemiddelde van alle netbeheerders.","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"netbeheerder_gas","in":"query","required":false,"description":"Netbeheerder voor gas als die anders is dan voor stroom (bijv. stroom enexis, gas rendo).","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"postcode","in":"query","required":false,"description":"Alleen de 4 cijfers van de postcode; we leiden er de netbeheerders voor stroom en gas uit af (open data van de netbeheerders). Geen letters, geen huisnummer.","schema":{"type":"string","pattern":"^[1-9][0-9]{3}$"},"example":"3511"},{"name":"auto","in":"query","required":false,"description":"Er laadt thuis een elektrische auto. Die kWh komen bovenop kwh (vul daar het verbruik zonder de auto in). auto_km of auto_kwh alleen betekent ook auto.","schema":{"type":"boolean"}},{"name":"auto_km","in":"query","required":false,"description":"Kilometers per jaar met de elektrische auto (standaard 15000).","schema":{"type":"integer","minimum":1,"maximum":100000}},{"name":"auto_verbruik","in":"query","required":false,"description":"Verbruik van de auto in kWh per 100 km (standaard 18; komma of punt).","schema":{"type":"number","minimum":5,"maximum":50}},{"name":"auto_kwh","in":"query","required":false,"description":"Of direct: laadstroom van de auto per jaar in kWh (gaat voor auto_km × auto_verbruik).","schema":{"type":"integer","minimum":1,"maximum":30000}},{"name":"slim_laden","in":"query","required":false,"description":"De auto laadt slim: automatisch in de goedkoopste uren (dynamisch: elke nacht 21:00–07:00; dubbele meter: 95% dal in plaats van 80%).","schema":{"type":"boolean"}},{"name":"auto_1fase","in":"query","required":false,"description":"Laadpaal op 1 fase (3,7 kW in plaats van 11 kW); telt bij slim laden met een dynamisch contract.","schema":{"type":"boolean"}},{"name":"ingang","in":"query","required":false,"description":"Ingangsdatum van het contract (vandaag tot over 12 maanden). Standaard: de eerste van volgende maand.","schema":{"type":"string","format":"date"}},{"name":"contract","in":"query","required":false,"description":"Alleen deze contractvorm.","schema":{"type":"string","enum":["vast","variabel","dynamisch"]}},{"name":"looptijd","in":"query","required":false,"description":"Alleen vaste contracten met deze looptijd in jaren.","schema":{"type":"integer","enum":[1,2,3,5]}},{"name":"groen","in":"query","required":false,"description":"Alleen groene stroom (Nederland, Europa of land niet vermeld). \"Herkomst onbekend\" telt niet als groen. Ook \"nl\" mag: zie groen_nl.","schema":{"type":"boolean"}},{"name":"groen_nl","in":"query","required":false,"description":"Alleen groene stroom uit Nederland (Garanties van Oorsprong uit Nederland, volgens de leverancier). Gaat voor groen.","schema":{"type":"boolean"}},{"name":"aantal","in":"query","required":false,"description":"Aantal aanbiedingen per groep (standaard 5; bij eigen-contract 3).","schema":{"type":"integer","minimum":1,"maximum":10}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Comparison"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/eigen-contract":{"get":{"tags":["Berekenen"],"operationId":"eigenContract","summary":"Kosten van je huidige contract naast de goedkoopste aanbiedingen","description":"Rekent met de rekenkern uit wat het huidige contract kost met de tarieven van de jaarnota of het contract, voor hetzelfde huishouden als /vergelijk, en zet dat naast de goedkoopste aanbiedingen met de besparing in het eerste jaar (zonder welkomstbonus) en het aantal goedkopere aanbiedingen. Bedragen in euro met punt of komma. Netbeheerkosten en energiebelasting geef je niet op: die zijn bij elke leverancier gelijk. We bewaren de tarieven niet; het antwoord heeft `Cache-Control: private, no-store`. Limiet: 30 verzoeken per minuut.","parameters":[{"name":"kwh","in":"query","required":false,"description":"Stroomverbruik per jaar (enkeltarief), kWh.","schema":{"type":"integer","minimum":0,"maximum":100000},"example":2500},{"name":"kwh_normaal","in":"query","required":false,"description":"Verbruik normaaltarief per jaar, kWh (samen met kwh_dal; gaat voor kwh).","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"kwh_dal","in":"query","required":false,"description":"Verbruik daltarief per jaar, kWh.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"m3","in":"query","required":false,"description":"Gasverbruik per jaar, m³.","schema":{"type":"integer","minimum":0,"maximum":20000},"example":1200},{"name":"geen_gas","in":"query","required":false,"description":"Geen gasaansluiting.","schema":{"type":"boolean"}},{"name":"teruglevering","in":"query","required":false,"description":"Teruglevering aan het net per jaar (zonnepanelen), kWh. Gaat voor zonnepanelen_wp.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"zonnepanelen_wp","in":"query","required":false,"description":"Alleen als de teruglevering niet bekend is: vermogen van alle zonnepanelen samen, Wp. kwh (of kwh_normaal + kwh_dal) is dan het totale eigen verbruik; de rekenkern schat per uur (weer van de afgelopen 12 maanden, ligging onbekend) de afname van het net en de teruglevering. Zie household.solar_estimate en assumptions; de url rekent met dezelfde afname en teruglevering.","schema":{"type":"integer","minimum":0,"maximum":80000},"example":4300},{"name":"aantal_panelen","in":"query","required":false,"description":"Of: aantal zonnepanelen (met wp_per_paneel), in plaats van zonnepanelen_wp.","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"wp_per_paneel","in":"query","required":false,"description":"Vermogen per paneel, Wp (standaard het paneel waarmee Milieu Centraal rekent).","schema":{"type":"integer","minimum":100,"maximum":800}},{"name":"aansluiting","in":"query","required":false,"description":"Aansluitwaarde van de stroomaansluiting (standaard 3x25). Een grotere aansluiting heeft hogere netbeheerkosten. Ook \"3x35A\" of \"e_3x35\" mag.","schema":{"type":"string","enum":["1x6","1x10","3x25","3x35","3x50","3x63","3x80"]}},{"name":"netbeheerder","in":"query","required":false,"description":"Netbeheerder voor stroom, en ook voor gas als netbeheerder_gas ontbreekt (gaat voor postcode). Zonder netbeheerder en postcode: gemiddelde van alle netbeheerders.","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"netbeheerder_gas","in":"query","required":false,"description":"Netbeheerder voor gas als die anders is dan voor stroom (bijv. stroom enexis, gas rendo).","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"postcode","in":"query","required":false,"description":"Alleen de 4 cijfers van de postcode; we leiden er de netbeheerders voor stroom en gas uit af (open data van de netbeheerders). Geen letters, geen huisnummer.","schema":{"type":"string","pattern":"^[1-9][0-9]{3}$"},"example":"3511"},{"name":"auto","in":"query","required":false,"description":"Er laadt thuis een elektrische auto. Die kWh komen bovenop kwh (vul daar het verbruik zonder de auto in). auto_km of auto_kwh alleen betekent ook auto.","schema":{"type":"boolean"}},{"name":"auto_km","in":"query","required":false,"description":"Kilometers per jaar met de elektrische auto (standaard 15000).","schema":{"type":"integer","minimum":1,"maximum":100000}},{"name":"auto_verbruik","in":"query","required":false,"description":"Verbruik van de auto in kWh per 100 km (standaard 18; komma of punt).","schema":{"type":"number","minimum":5,"maximum":50}},{"name":"auto_kwh","in":"query","required":false,"description":"Of direct: laadstroom van de auto per jaar in kWh (gaat voor auto_km × auto_verbruik).","schema":{"type":"integer","minimum":1,"maximum":30000}},{"name":"slim_laden","in":"query","required":false,"description":"De auto laadt slim: automatisch in de goedkoopste uren (dynamisch: elke nacht 21:00–07:00; dubbele meter: 95% dal in plaats van 80%).","schema":{"type":"boolean"}},{"name":"auto_1fase","in":"query","required":false,"description":"Laadpaal op 1 fase (3,7 kW in plaats van 11 kW); telt bij slim laden met een dynamisch contract.","schema":{"type":"boolean"}},{"name":"ingang","in":"query","required":false,"description":"Ingangsdatum van het contract (vandaag tot over 12 maanden). Standaard: de eerste van volgende maand.","schema":{"type":"string","format":"date"}},{"name":"contract","in":"query","required":false,"description":"Alleen deze contractvorm.","schema":{"type":"string","enum":["vast","variabel","dynamisch"]}},{"name":"looptijd","in":"query","required":false,"description":"Alleen vaste contracten met deze looptijd in jaren.","schema":{"type":"integer","enum":[1,2,3,5]}},{"name":"groen","in":"query","required":false,"description":"Alleen groene stroom (Nederland, Europa of land niet vermeld). \"Herkomst onbekend\" telt niet als groen. Ook \"nl\" mag: zie groen_nl.","schema":{"type":"boolean"}},{"name":"groen_nl","in":"query","required":false,"description":"Alleen groene stroom uit Nederland (Garanties van Oorsprong uit Nederland, volgens de leverancier). Gaat voor groen.","schema":{"type":"boolean"}},{"name":"aantal","in":"query","required":false,"description":"Aantal aanbiedingen per groep (standaard 5; bij eigen-contract 3).","schema":{"type":"integer","minimum":1,"maximum":10}},{"name":"stroomprijs","in":"query","required":false,"description":"Leveringsprijs stroom per kWh (enkeltarief), euro. Of stroomprijs_normaal en stroomprijs_dal.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"},"example":"0.2834"},{"name":"stroomprijs_normaal","in":"query","required":false,"description":"Leveringsprijs stroom normaaltarief per kWh, euro.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"stroomprijs_dal","in":"query","required":false,"description":"Leveringsprijs stroom daltarief per kWh, euro.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"gasprijs","in":"query","required":false,"description":"Leveringsprijs gas per m³, euro (verplicht met gas, tenzij inkoopvergoeding_gas bij dynamisch).","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"},"example":"1.25"},{"name":"vaste_kosten_stroom","in":"query","required":false,"description":"Vaste leveringskosten van de leverancier voor stroom, euro per maand (niet de netbeheerkosten).","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"vaste_kosten_gas","in":"query","required":false,"description":"Vaste leveringskosten van de leverancier voor gas, euro per maand.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"vaste_kosten","in":"query","required":false,"description":"Of: alle vaste leveringskosten samen, euro per maand.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"},"example":"13.90"},{"name":"inkoopvergoeding_stroom","in":"query","required":false,"description":"Dynamisch contract: inkoopvergoeding per kWh, euro (dan geen stroomprijs).","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"inkoopvergoeding_gas","in":"query","required":false,"description":"Dynamisch contract: inkoopvergoeding gas per m³, euro.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"terugleververgoeding","in":"query","required":false,"description":"Zonnepanelen: vergoeding per kWh die je ontvangt (zonder btw), euro. Leeg: vanaf 2027 het wettelijk minimum.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"terugleverkosten","in":"query","required":false,"description":"Zonnepanelen: terugleverkosten per kWh, euro (dynamisch: de verkoopvergoeding). Leeg: vanaf 2027 de mediaan van de markt.","schema":{"type":"string","pattern":"^[0-9]{1,6}([.,][0-9]{1,6})?$"}},{"name":"prijsbasis","in":"query","required":false,"description":"Basis van de opgegeven prijzen. Standaard incl_btw (incl. btw, excl. energiebelasting, zoals op de meeste jaarnota's); all_in = incl. btw én energiebelasting.","schema":{"type":"string","enum":["incl_btw","excl_btw","all_in"]}},{"name":"einddatum","in":"query","required":false,"description":"Einddatum van je vaste contract (jjjj-mm-dd of dd-mm-jjjj). Geeft `contract_end`: een indicatie van de opzegvergoeding (Energiewet: (jouw prijs − referentieproduct van je leverancier) × resterend verbruik), de besparing tot de einddatum en vanaf wanneer overstappen loont.","schema":{"type":"string"},"example":"2028-10-13"},{"name":"leverancier","in":"query","required":false,"description":"Bij einddatum: slug of naam van je huidige leverancier (voor het referentieproduct).","schema":{"type":"string"},"example":"eneco"}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/OwnContract"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/dynamisch-of-vast":{"get":{"tags":["Berekenen"],"operationId":"dynamischOfVast","summary":"Vast, variabel en dynamisch naast elkaar, met dynamisch bij andere beursprijzen","description":"Voor hetzelfde huishouden als /vergelijk: het goedkoopste vaste 1-jaarscontract, het goedkoopste vaste van elke looptijd, het goedkoopste variabele en het goedkoopste dynamische contract (schatting met bandbreedte), plus hetzelfde dynamische contract met de day-ahead-prijzen van een duur jaar (2022), een gewoon jaar (2024), een goedkoop jaar (2020) en het niveau van de afgelopen 30 dagen. Limiet: 30 verzoeken per minuut.","parameters":[{"name":"kwh","in":"query","required":false,"description":"Stroomverbruik per jaar (enkeltarief), kWh.","schema":{"type":"integer","minimum":0,"maximum":100000},"example":2500},{"name":"kwh_normaal","in":"query","required":false,"description":"Verbruik normaaltarief per jaar, kWh (samen met kwh_dal; gaat voor kwh).","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"kwh_dal","in":"query","required":false,"description":"Verbruik daltarief per jaar, kWh.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"m3","in":"query","required":false,"description":"Gasverbruik per jaar, m³.","schema":{"type":"integer","minimum":0,"maximum":20000},"example":1200},{"name":"geen_gas","in":"query","required":false,"description":"Geen gasaansluiting.","schema":{"type":"boolean"}},{"name":"teruglevering","in":"query","required":false,"description":"Teruglevering aan het net per jaar (zonnepanelen), kWh. Gaat voor zonnepanelen_wp.","schema":{"type":"integer","minimum":0,"maximum":100000}},{"name":"zonnepanelen_wp","in":"query","required":false,"description":"Alleen als de teruglevering niet bekend is: vermogen van alle zonnepanelen samen, Wp. kwh (of kwh_normaal + kwh_dal) is dan het totale eigen verbruik; de rekenkern schat per uur (weer van de afgelopen 12 maanden, ligging onbekend) de afname van het net en de teruglevering. Zie household.solar_estimate en assumptions; de url rekent met dezelfde afname en teruglevering.","schema":{"type":"integer","minimum":0,"maximum":80000},"example":4300},{"name":"aantal_panelen","in":"query","required":false,"description":"Of: aantal zonnepanelen (met wp_per_paneel), in plaats van zonnepanelen_wp.","schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"wp_per_paneel","in":"query","required":false,"description":"Vermogen per paneel, Wp (standaard het paneel waarmee Milieu Centraal rekent).","schema":{"type":"integer","minimum":100,"maximum":800}},{"name":"aansluiting","in":"query","required":false,"description":"Aansluitwaarde van de stroomaansluiting (standaard 3x25). Een grotere aansluiting heeft hogere netbeheerkosten. Ook \"3x35A\" of \"e_3x35\" mag.","schema":{"type":"string","enum":["1x6","1x10","3x25","3x35","3x50","3x63","3x80"]}},{"name":"netbeheerder","in":"query","required":false,"description":"Netbeheerder voor stroom, en ook voor gas als netbeheerder_gas ontbreekt (gaat voor postcode). Zonder netbeheerder en postcode: gemiddelde van alle netbeheerders.","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"netbeheerder_gas","in":"query","required":false,"description":"Netbeheerder voor gas als die anders is dan voor stroom (bijv. stroom enexis, gas rendo).","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"postcode","in":"query","required":false,"description":"Alleen de 4 cijfers van de postcode; we leiden er de netbeheerders voor stroom en gas uit af (open data van de netbeheerders). Geen letters, geen huisnummer.","schema":{"type":"string","pattern":"^[1-9][0-9]{3}$"},"example":"3511"},{"name":"auto","in":"query","required":false,"description":"Er laadt thuis een elektrische auto. Die kWh komen bovenop kwh (vul daar het verbruik zonder de auto in). auto_km of auto_kwh alleen betekent ook auto.","schema":{"type":"boolean"}},{"name":"auto_km","in":"query","required":false,"description":"Kilometers per jaar met de elektrische auto (standaard 15000).","schema":{"type":"integer","minimum":1,"maximum":100000}},{"name":"auto_verbruik","in":"query","required":false,"description":"Verbruik van de auto in kWh per 100 km (standaard 18; komma of punt).","schema":{"type":"number","minimum":5,"maximum":50}},{"name":"auto_kwh","in":"query","required":false,"description":"Of direct: laadstroom van de auto per jaar in kWh (gaat voor auto_km × auto_verbruik).","schema":{"type":"integer","minimum":1,"maximum":30000}},{"name":"slim_laden","in":"query","required":false,"description":"De auto laadt slim: automatisch in de goedkoopste uren (dynamisch: elke nacht 21:00–07:00; dubbele meter: 95% dal in plaats van 80%).","schema":{"type":"boolean"}},{"name":"auto_1fase","in":"query","required":false,"description":"Laadpaal op 1 fase (3,7 kW in plaats van 11 kW); telt bij slim laden met een dynamisch contract.","schema":{"type":"boolean"}},{"name":"ingang","in":"query","required":false,"description":"Ingangsdatum van het contract (vandaag tot over 12 maanden). Standaard: de eerste van volgende maand.","schema":{"type":"string","format":"date"}},{"name":"groen_nl","in":"query","required":false,"description":"Alleen groene stroom uit Nederland (Garanties van Oorsprong uit Nederland, volgens de leverancier). Gaat voor groen.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/DynamicOrFixed"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/advies":{"get":{"tags":["Advies"],"operationId":"advies","summary":"Welke contractvorm past bij het prijsniveau nu (vuistregel, geen voorspelling)","description":"Zoals op https://enfy.nl/advies/welk-energiecontract. De beursprijs van stroom en gas van de afgelopen 30 dagen tegenover elke volledige maand sinds 2018-01, samen gewogen met het verbruik van een gemiddeld huishouden. Percentiel vanaf 67 = hoog: flexibel (variabel, vast 1 jaar, dynamisch); tot en met 33 = laag: langer vast overwegen; daartussen geen voorkeur. Plus wat elke contractvorm nu kost voor een gemiddeld huishouden (`term_spread`). Het advies is hetzelfde voor elk huishouden en verandert niets aan de volgorde op kosten. **Neem `disclaimer` altijd over** als je het advies doorgeeft.","responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContractAdvice"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/netbeheerder":{"get":{"tags":["Berekenen"],"operationId":"netbeheerder","summary":"Netbeheerder en netbeheerkosten bij een postcodegebied","description":"De netbeheerder voor stroom en gas bij de 4 cijfers van een postcode (open kleinverbruiksgegevens van de netbeheerders, met het aandeel in het gebied) en de netbeheerkosten per jaar en per maand incl. btw, dit jaar en volgend jaar, plus stroom per aansluitwaarde. Netbeheerkosten zijn bij elke leverancier gelijk.","parameters":[{"name":"postcode","in":"query","required":false,"description":"Alleen de 4 cijfers van de postcode (of netbeheerder).","schema":{"type":"string","pattern":"^[1-9][0-9]{3}$"},"example":"7707"},{"name":"netbeheerder","in":"query","required":false,"description":"In plaats van postcode: netbeheerder voor stroom (en gas).","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"netbeheerder_gas","in":"query","required":false,"description":"Netbeheerder voor gas als die anders is.","schema":{"type":"string","enum":["liander","stedin","enexis","westland-infra","coteq","rendo"]}},{"name":"aansluiting","in":"query","required":false,"description":"Aansluitwaarde stroom (standaard 3x25).","schema":{"type":"string","enum":["1x6","1x10","3x25","3x35","3x50","3x63","3x80"]}},{"name":"m3","in":"query","required":false,"description":"Gasverbruik per jaar; bepaalt de gascategorie.","schema":{"type":"integer","minimum":0,"maximum":20000}},{"name":"geen_gas","in":"query","required":false,"description":"Geen gasaansluiting.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/GridOperator"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/prijswijzigingen":{"get":{"tags":["Leveranciers"],"operationId":"prijswijzigingen","summary":"Gecontroleerde tariefwijzigingen, nieuwste ingangsdatum eerst","description":"Tarieven incl. btw, excl. energiebelasting en netbeheer (de terugleververgoeding zonder btw). Het effect per maand is voor een gemiddeld huishouden, berekend met de rekenkern. Zoals op /prijswijzigingen; ook als RSS (/prijswijzigingen.xml).","parameters":[{"name":"leverancier","in":"query","required":false,"description":"Slug van één leverancier.","schema":{"type":"string"},"example":"vattenfall"},{"name":"alleen_komend","in":"query","required":false,"description":"Alleen wijzigingen met een ingangsdatum vandaag of later.","schema":{"type":"boolean"}},{"name":"aantal","in":"query","required":false,"description":"Aantal wijzigingen (standaard 10).","schema":{"type":"integer","minimum":1,"maximum":25}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PriceChanges"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/historie/{onderwerp}":{"get":{"tags":["Historie"],"operationId":"historie","summary":"Energieprijzen en energiebelasting door de jaren","description":"Per jaar (nieuwste eerst) en de laatste 13 maanden, met bronnen en licenties: CBS-leveringsprijzen (incl. btw, excl. energiebelasting), Eurostat all-in, de gasbeursprijs, de energiebelasting sinds 1996 en de gemiddelde day-ahead-prijs. Zoals op /energieprijzen/historie.","parameters":[{"name":"onderwerp","in":"path","required":true,"schema":{"type":"string","enum":["stroom","gas","energiebelasting","day-ahead"]},"example":"stroom"},{"name":"vanaf_jaar","in":"query","required":false,"description":"Alleen jaren vanaf dit jaar.","schema":{"type":"integer","minimum":1990},"example":2020}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/PriceHistory"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/leveranciers":{"get":{"tags":["Leveranciers"],"operationId":"leveranciers","summary":"Actieve leveranciers en hun dekking","responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProviderList"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/leveranciers/{slug}":{"get":{"tags":["Leveranciers"],"operationId":"leverancier","summary":"Tarieven van één leverancier (zoals op de leverancierspagina)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"example":"vattenfall"}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ProviderDetail"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/tarieven":{"get":{"tags":["Leveranciers"],"operationId":"tarieven","summary":"Laagste, mediaan, gemiddeld en hoogste tarief per contractvorm","description":"Geaggregeerd over alle leveranciers in de vergelijking; geen tarieven per leverancier. Incl. btw, excl. energiebelasting en netbeheer. Dynamisch: de inkoopvergoeding. Plus het totaal per maand voor een gemiddeld huishouden (rekenkern). Dezelfde cijfers als de open-data-download.","responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/TariffAggregates"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/dynamisch/{datum}":{"get":{"tags":["Marktprijzen"],"operationId":"dynamisch","summary":"Day-ahead-stroomprijs per kwartier en uur","description":"Kaal (`spot`: beursprijs excl. btw en energiebelasting) en all-in (`all_in`: (beursprijs + inkoopvergoeding + energiebelasting) × 1,21), per kWh. Zonder `leverancier`: de gemiddelde inkoopvergoeding van de dynamische leveranciers.","parameters":[{"name":"datum","in":"path","required":true,"description":"JJJJ-MM-DD, of vandaag, morgen, gisteren.","schema":{"type":"string"},"example":"vandaag"},{"name":"leverancier","in":"query","required":false,"description":"Slug van een dynamische leverancier: all-in met diens inkoopvergoeding.","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ElectricityDay"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/gas/{gasdag}":{"get":{"tags":["Marktprijzen"],"operationId":"gas","summary":"Gasprijs per gasdag (06:00–06:00)","parameters":[{"name":"gasdag","in":"path","required":true,"description":"JJJJ-MM-DD (de gasdag begint om 06:00), of vandaag (vóór 06:00: de gasdag van gisteren).","schema":{"type":"string"},"example":"vandaag"}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/GasDay"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/energiebelasting/{jaar}":{"get":{"tags":["Belasting"],"operationId":"energiebelasting","summary":"Energiebelasting en belastingvermindering per jaar","parameters":[{"name":"jaar","in":"path","required":true,"schema":{"type":"integer"},"example":2027}],"responses":{"200":{"description":"OK","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EnergyTax"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"$ref":"#/components/responses/KeyInQuery"},"401":{"$ref":"#/components/responses/InvalidApiKey"},"403":{"$ref":"#/components/responses/InsufficientScope"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/InvalidInput"},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"responses":{"NotFound":{"description":"Niet gevonden","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InvalidInput":{"description":"Ongeldige invoer; `error.fields` noemt per veld wat er mis is","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Te veel verzoeken; zie Retry-After","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Rekenkern of data tijdelijk niet beschikbaar","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InvalidApiKey":{"description":"API-sleutel ongeldig, ingetrokken of verlopen (`invalid_api_key`); stuur geen sleutel om anoniem te werken","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InsufficientScope":{"description":"De API-sleutel mist de scope voor dit adres (`insufficient_scope`)","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"KeyInQuery":{"description":"API-sleutel in de URL (`api_key_in_query`); stuur hem in de header X-Api-Key","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Optioneel. Vorm `enfy_prd_…` (40 tekens na het voorvoegsel). Scopes: `public` = alle endpoints en /mcp met de limieten van de sleutel; `compare` = eigen, hogere limiet voor vergelijk, eigen-contract en dynamisch-of-vast (zonder deze scope de anonieme limiet, per sleutel geteld); `ops:read` = de interne MCP-server (alleen intern). Ook `Authorization: Bearer enfy_…` werkt. Nooit in de querystring."}},"headers":{"X-RateLimit-Limit":{"description":"Verzoeken per minuut.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Resterende verzoeken in deze minuut.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Moment (Unix-tijd) waarop de teller weer vrij is.","schema":{"type":"integer"}}},"schemas":{"Meta":{"type":"object","required":["source","url","attribution"],"properties":{"source":{"type":"string","example":"enfy"},"url":{"type":"string","format":"uri","description":"Onze pagina met dezelfde cijfers."},"attribution":{"type":"string","description":"Te tonen bronvermelding: \"Bron: <merk>, <url>\"."},"calculated_at":{"type":"string","format":"date-time","description":"Moment van de berekening (alleen bij vergelijk)."},"generated_at":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_input","invalid_date","invalid_year","not_found","rate_limited","request_too_large","unavailable"]},"message":{"type":"string"},"fields":{"type":"object","additionalProperties":{"type":"string"}}}}}},"CostLine":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"},"group":{"type":"string","enum":["electricity","gas","grid","tax","feed_in","discount"]},"calculation":{"type":"string","example":"2.500 kWh × € 0,0880"},"excl_vat_cents":{"type":"integer"},"vat_cents":{"type":"integer"},"incl_vat_cents":{"type":"integer"},"incl_vat":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."}}},"Assumption":{"type":"object","properties":{"code":{"type":"string"},"prefix":{"type":"string","example":"Aanname"},"label":{"type":"string"},"text":{"type":"string"}}},"GreenOrigin":{"type":"object","description":"Groene of grijze stroom en de herkomst, genormaliseerd uit de eigen pagina's en het stroometiket van de leverancier (onderzoek met bron en datum). \"unknown\" = niet vast te stellen; dat telt nooit als groen. Null per commodity als het product die niet levert.","properties":{"electricity":{"type":["object","null"],"properties":{"class":{"type":"string","enum":["green_nl","green_eu","green_unknown_origin","grey","unknown"],"description":"green_nl = groen uit Nederland; green_eu = groen, (deels) uit andere Europese landen; green_unknown_origin = groen, land niet vermeld; grey = grijze stroom; unknown = onbekend."},"label":{"type":"string","example":"Groene stroom · Nederland (wind en zon)"},"sources":{"type":"array","items":{"type":"string","enum":["wind","zon","water","biomassa"]}},"source_url":{"type":["string","null"],"format":"uri","description":"Pagina of stroometiket van de leverancier."},"checked_at":{"type":["string","null"],"format":"date"}}},"gas":{"type":["object","null"],"properties":{"class":{"type":"string","enum":["groen_gas","co2_compensated","grey","unknown"],"description":"groen_gas; co2_compensated = aardgas met CO2-compensatie; grey = aardgas zonder compensatie; unknown = niet vermeld."},"label":{"type":"string","example":"Gas CO₂-gecompenseerd"},"source_url":{"type":["string","null"],"format":"uri"},"checked_at":{"type":["string","null"],"format":"date"}}}}},"Offer":{"type":"object","properties":{"rank":{"type":"integer","description":"Plek op kosten (1 = goedkoopst)."},"provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"product":{"type":"object","properties":{"name":{"type":"string"},"form":{"type":"string","example":"fixed-12"},"form_label":{"type":"string"},"contract_type":{"type":"string","enum":["fixed","variable","dynamic"]},"duration_months":{"type":["integer","null"]},"green":{"type":"object","description":"Herkomst zoals de leverancier hem omschrijft (vrije tekst, electricity en gas; null = niet opgegeven)."},"green_origin":{"$ref":"#/components/schemas/GreenOrigin"}}},"monthly_cents":{"type":["integer","null"],"description":"Maandbedrag (kosten eerste jaar / 12) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"monthly":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"year1_cents":{"type":["integer","null"],"description":"Kosten eerste jaar zonder welkomstbonus in centen (incl. btw, tenzij de naam excl_vat bevat)."},"year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"year1_with_bonus_cents":{"type":["integer","null"],"description":"Kosten eerste jaar min het deel van de welkomstbonus voor dat jaar (een meerjarige bonus verdeeld over de contractjaren) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"year1_with_bonus":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"one_off_discount_cents":{"type":["integer","null"],"description":"Welkomstbonus/cashback in centen (incl. btw, tenzij de naam excl_vat bevat)."},"one_off_discount":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"one_off_discount_year1_cents":{"type":["integer","null"],"description":"Deel van de bonus dat in het eerste jaar meetelt: bonus / aantal contractjaren in centen (incl. btw, tenzij de naam excl_vat bevat)."},"one_off_discount_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"bonus":{"type":["object","null"],"description":"Welkomstbonus (ook in compacte antwoorden): total_cents, year1_cents (deel in het eerste jaar), years (aantal contractjaren waarover verdeeld) en explanation (één zin). Null zonder bonus."},"contract_total_cents":{"type":["integer","null"],"description":"Kosten over de hele looptijd in centen (incl. btw, tenzij de naam excl_vat bevat)."},"contract_total":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"difference_vs_average_cents":{"type":["integer","null"],"description":"Verschil met het gemiddelde (negatief = goedkoper) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"difference_vs_average":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"is_estimate":{"type":"boolean","description":"Dynamisch: schatting op basis van de afgelopen 12 maanden."},"ev":{"type":["object","null"],"description":"Elektrische auto (null zonder auto): kosten van de laadstroom bij deze aanbieding incl. energiebelasting en btw. kwh, smart_charging, year1_cents (zoals opgegeven), plain_year1_cents (zonder slim laden), smart_year1_cents (met slim laden), smart_saving_cents, plain_price_micro en smart_price_micro (gemiddeld per kWh), elk met tekstveld."},"estimate_range":{"type":["object","null"],"description":"P10–P90 bij dynamisch."},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CostLine"}},"feed_in_assumptions":{"type":"array","items":{"$ref":"#/components/schemas/Assumption"}},"assumptions":{"type":"array","items":{"type":"string"}},"tariff":{"type":"object","properties":{"valid_from":{"type":["string","null"],"format":"date"},"checked_at":{"type":["string","null"],"format":"date-time"}}},"url":{"type":"string","format":"uri","description":"Onze resultaatpagina met dezelfde invoer, op deze aanbieding."},"provider_url":{"type":"string","format":"uri","description":"Onze pagina over de leverancier."}}},"PaidPosition":{"allOf":[{"$ref":"#/components/schemas/Offer"},{"type":"object","properties":{"label":{"type":"string","const":"Betaalde positie"},"cost_rank":{"type":"integer","description":"Plek van deze aanbieding op kosten."},"cost_rank_label":{"type":"string","example":"plek 6 op kosten"}}}]},"Comparison":{"type":"object","properties":{"household":{"type":"object","properties":{"kwh":{"type":"integer"},"kwh_normal":{"type":["integer","null"]},"kwh_low":{"type":["integer","null"]},"m3":{"type":"integer"},"has_gas":{"type":"boolean"},"feed_in_kwh":{"type":"integer"},"connection":{"type":"string","enum":["e_1x6","e_1x10","e_3x25","e_3x35","e_3x50","e_3x63","e_3x80"]},"connection_label":{"type":"string"},"start_date":{"type":"string","format":"date"},"grid_operator":{"type":"object","description":"Netbeheerder stroom; slug null = gemiddelde van alle netbeheerders.","properties":{"slug":{"type":["string","null"]},"name":{"type":"string"}}},"grid_operator_gas":{"type":["object","null"],"description":"Netbeheerder gas; null zonder gas.","properties":{"slug":{"type":["string","null"]},"name":{"type":"string"}}},"ev":{"type":["object","null"],"description":"Elektrische auto bovenop kwh; null zonder auto.","properties":{"kwh":{"type":"integer"},"km":{"type":["integer","null"]},"kwh_per_100km":{"type":["number","null"]},"smart_charging":{"type":"boolean"},"charger_kw":{"type":"number"},"description":{"type":"string"}}},"solar_estimate":{"type":["object","null"],"description":"Alleen met zonnepanelen_wp (of aantal_panelen) zonder teruglevering: de schatting van de rekenkern. import_kwh = kwh, export_kwh = feed_in_kwh; null anders.","properties":{"total_wp":{"type":"integer"},"panels":{"type":["integer","null"]},"panel_wp":{"type":["integer","null"]},"kwh_per_kwp":{"type":"integer"},"production_kwh":{"type":"integer"},"use_kwh":{"type":"integer"},"self_use_kwh":{"type":"integer"},"import_kwh":{"type":"integer"},"export_kwh":{"type":"integer"},"period":{"type":"object","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"}}},"weather":{"type":"string","enum":["knmi","profile"]},"description":{"type":"string"}}}}},"filters":{"type":"object"},"ranking":{"type":"string"},"offers":{"type":"array","items":{"$ref":"#/components/schemas/Offer"},"description":"Vast en variabel, op kosten."},"dynamic":{"type":"array","items":{"$ref":"#/components/schemas/Offer"},"description":"Dynamisch, aparte groep (schatting), op kosten."},"paid_positions":{"type":"array","items":{"$ref":"#/components/schemas/PaidPosition"},"description":"Betaalde posities, nooit in de volgorde. Leeg zolang geen leverancier betaalt."},"counts":{"type":"object"},"average_year1_cents":{"type":["integer","null"],"description":"Gemiddelde kosten eerste jaar in centen (incl. btw, tenzij de naam excl_vat bevat)."},"average_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"calculated_at":{"type":"string","format":"date-time"},"assumptions":{"type":"array","items":{"type":"string"}},"disclosure":{"type":"string","description":"Hoe de site geld verdient."},"result_url":{"type":"string","format":"uri"},"attribution":{"type":"string"}}},"ProviderList":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"supplies":{"type":"object"},"contract_forms":{"type":"array","items":{"type":"string"}},"products_with_tariffs":{"type":"integer"},"region_restriction":{"type":"string"},"coverage":{"$ref":"#/components/schemas/Coverage"}}}},"Coverage":{"type":"object","properties":{"status":{"type":"string","enum":["included","stale","excluded","no_tariffs"]},"label":{"type":"string"},"reason":{"type":"string"},"last_checked_at":{"type":["string","null"],"format":"date-time"}}},"ProviderDetail":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"service_score":{"type":["number","null"],"description":"Servicescore 0–10 uit reviews."},"coverage":{"$ref":"#/components/schemas/Coverage"},"basis":{"type":"string"},"products":{"type":"array","items":{"type":"object","description":"Per product de gepubliceerde tarieven, teruglevering 2026 en vanaf 2027, geldig vanaf, gecontroleerd op en de kosten voor het gemiddelde huishouden."}}}},"Stats":{"type":["object","null"],"description":"min/median/average/max: *_micro of *_cents incl. btw (en als tekst), *_excl_vat_micro/_cents excl. btw (niet bij monthly_household). null als er geen waarden zijn.","properties":{"unit":{"type":"string"},"count":{"type":"integer"},"field":{"type":"string","enum":["single_or_normal","supply_price","purchase_fee","fixed_monthly","household_monthly"]}},"additionalProperties":{"type":["integer","string","null"]}},"TariffAggregates":{"type":"object","properties":{"generated_at":{"type":"string","format":"date-time"},"checked_at":{"type":["string","null"],"format":"date-time","description":"Laatste controle van de tarieven."},"data_version":{"type":"string"},"basis":{"type":"object"},"forms":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string","example":"fixed-12"},"label":{"type":"string"},"contract_type":{"type":"string"},"duration_months":{"type":["integer","null"]},"suppliers":{"type":"integer"},"products":{"type":"integer"},"price_kind":{"type":"string","enum":["supply_price","purchase_fee"]},"electricity":{"$ref":"#/components/schemas/Stats"},"gas":{"$ref":"#/components/schemas/Stats"},"fixed_monthly_electricity":{"$ref":"#/components/schemas/Stats"},"fixed_monthly_gas":{"$ref":"#/components/schemas/Stats"},"monthly_household":{"$ref":"#/components/schemas/Stats"}}}}}},"PricePoint":{"type":"object","properties":{"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"spot_micro":{"type":"integer","description":"Kaal: excl. btw en energiebelasting."},"spot":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"all_in_micro":{"type":["integer","null"],"description":"Incl. inkoopvergoeding, energiebelasting en btw."},"all_in":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."}}},"ElectricityDay":{"type":"object","properties":{"date":{"type":"string","format":"date"},"resolution":{"type":"string","enum":["PT15M","PT60M"]},"unit":{"type":"string","const":"kWh"},"source":{"type":"string"},"validated":{"type":"boolean"},"all_in_basis":{"type":"object"},"summary":{"type":"object"},"hours":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"}},"slots":{"type":"array","items":{"$ref":"#/components/schemas/PricePoint"},"description":"Per kwartier (leeg bij uurprijzen)."}}},"GasDay":{"type":"object","properties":{"gas_day":{"type":"string","format":"date"},"start":{"type":"string","format":"date-time"},"end":{"type":"string","format":"date-time"},"unit":{"type":"string","const":"m³"},"spot_micro":{"type":"integer"},"spot":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"all_in_micro":{"type":["integer","null"]},"all_in":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"all_in_basis":{"type":"object"}}},"OwnContract":{"type":"object","properties":{"household":{"type":"object","description":"Zelfde huishouden als bij /vergelijk."},"own":{"type":"object","properties":{"contract_type":{"type":"string","enum":["fixed","dynamic"],"description":"fixed = jouw vaste of variabele tarieven, 12 maanden gelijk."},"price_basis":{"type":"string","enum":["incl_btw","excl_btw","all_in"]},"price_basis_label":{"type":"string"},"tariffs":{"type":"object","description":"De tarieven zoals gerekend: *_excl_vat_micro (excl. btw en energiebelasting) en *_micro incl. btw."},"monthly_cents":{"type":["integer","null"],"description":"Jouw kosten per maand, eerste jaar in centen (incl. btw, tenzij de naam excl_vat bevat)."},"monthly":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"year1_cents":{"type":["integer","null"],"description":"Jouw kosten in het eerste jaar in centen (incl. btw, tenzij de naam excl_vat bevat)."},"year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"is_estimate":{"type":"boolean"},"estimate_range":{"type":["object","null"]},"lines":{"type":"array","items":{"$ref":"#/components/schemas/CostLine"}},"assumptions":{"type":"array","items":{"type":"string"}},"feed_in_assumptions":{"type":"array","items":{"$ref":"#/components/schemas/Assumption"}}}},"ranking":{"type":"string"},"alternatives":{"type":"array","description":"Goedkoopste vaste en variabele aanbiedingen (compact) met saving_year1_cents (jouw kosten min die van de aanbieding; negatief = duurder) en saving_year1_with_bonus_cents.","items":{"type":"object"}},"dynamic":{"type":"array","description":"Goedkoopste dynamische aanbiedingen (schatting), met besparing.","items":{"type":"object"}},"paid_positions":{"type":"array","items":{"type":"object"},"description":"Betaalde posities, nooit in de volgorde."},"cheaper":{"type":"object","description":"Aantal aanbiedingen dat goedkoper is dan jouw contract.","properties":{"offers":{"type":"integer"},"offers_total":{"type":"integer"},"dynamic":{"type":"integer"},"dynamic_total":{"type":"integer"}}},"best_saving_year1_cents":{"type":["integer","null"],"description":"Grootste besparing met een vast of variabel contract (0 als je contract goedkoper is dan alle vaste en variabele) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"best_saving_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"best_saving_dynamic_year1_cents":{"type":["integer","null"],"description":"Grootste besparing met een dynamisch contract (schatting) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"best_saving_dynamic_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"best_saving_dynamic_range":{"type":["object","null"],"description":"low_cents (bij een dure beurs, p90; negatief = duurder) en high_cents (goedkope beurs, p10) voor het goedkoopste dynamische contract. Ook per dynamische aanbieding als saving_range."},"contract_end":{"type":["object","null"],"description":"Alleen met einddatum: end_date, remaining_months, status (estimated, no_supplier, no_reference, ended, dynamic), termination_fee (total_cents, electricity_cents, gas_cents, reference), switch_now (saving_until_end_cents, net_cents), first_profitable_date, advice en notes."},"calculated_at":{"type":"string","format":"date-time"},"assumptions":{"type":"array","items":{"type":"string"}},"disclosure":{"type":"string"},"result_url":{"type":"string","format":"uri"}}},"DynamicOrFixed":{"type":"object","properties":{"answer":{"type":"string"},"household":{"type":"object"},"fixed_1_year":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"fixed_cheapest":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"variable":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"dynamic":{"oneOf":[{"$ref":"#/components/schemas/Offer"},{"type":"null"}]},"dynamic_minus_fixed_year1_cents":{"type":["integer","null"],"description":"Dynamisch min vast 1 jaar (negatief = dynamisch goedkoper) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"dynamic_minus_fixed_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"dynamic_minus_best_fixed_or_variable_year1_cents":{"type":["integer","null"],"description":"Dynamisch min de goedkoopste vaste (elke looptijd) of variabele aanbieding (negatief = dynamisch goedkoper) in centen (incl. btw, tenzij de naam excl_vat bevat)."},"dynamic_minus_best_fixed_or_variable_year1":{"type":["string","null"],"description":"Zelfde bedrag als tekst, bijv. \"€ 123,45\"."},"scenarios":{"type":"array","description":"Hetzelfde dynamische contract met de beursprijzen van stroom en gas van een ander jaar of van de afgelopen 30 dagen.","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"market_avg_micro":{"type":["integer","null"],"description":"Gemiddelde beursprijs stroom (micro-euro/kWh excl. btw)"},"gas_market_avg_micro":{"type":["integer","null"],"description":"Gemiddelde beursprijs gas (micro-euro/m³ excl. btw); null als de gasprijs van het contract niet met de beurs meebeweegt of zonder gas"},"dynamic_year1_cents":{"type":["integer","null"],"description":"Hetzelfde dynamische contract per jaar in centen (incl. btw, tenzij de naam excl_vat bevat)."},"difference_vs_fixed_cents":{"type":["integer","null"],"description":"Verschil met vast 1 jaar in centen (incl. btw, tenzij de naam excl_vat bevat)."}}}},"scenario_gas_follows_market":{"type":["boolean","null"],"description":"true: de gasprijs van het contract volgt de beurs en verandert per scenario mee; false: vaste of variabele gasprijs, alleen stroom verandert; null zonder gas."},"market":{"type":"object"},"considerations":{"type":"array","items":{"type":"string"}},"assumptions":{"type":"array","items":{"type":"string"}},"result_url":{"type":"string","format":"uri"},"rekenhulp_url":{"type":"string","format":"uri"},"contract_advice":{"oneOf":[{"$ref":"#/components/schemas/ContractAdvice"},{"type":"null"}],"description":"Ons algemene advies over de contractvorm (zoals /advies), met disclaimer; null zonder genoeg marktprijzen."}}},"ContractAdvice":{"type":"object","required":["date","answer","level","percentile","advice","disclaimer","url"],"properties":{"date":{"type":"string","format":"date"},"answer":{"type":"string","description":"Het advies met datum en prijsniveau, te citeren."},"level":{"type":"string","enum":["high","middle","low"]},"level_label":{"type":"string"},"percentile":{"type":"integer","minimum":0,"maximum":100,"description":"Deel van de maanden (%) met een lagere beurswaarde van stroom en gas dan nu."},"advice":{"type":"string","enum":["flexible","neutral","longer"]},"title":{"type":"string"},"text":{"type":"string"},"recommended_forms":{"type":"array","items":{"type":"object","properties":{"form":{"type":"string"},"label":{"type":"string"}}}},"reasons":{"type":"array","items":{"type":"string"}},"disclaimer":{"type":"string","description":"Altijd meenemen: geen voorspelling, geen garantie, geen persoonlijk advies; de volgorde blijft op kosten."},"rule":{"type":"object","description":"high_from_percentile, low_until_percentile en de regel als tekst."},"measure":{"type":"object","description":"Omschrijving, period_from/period_to (JJJJ-MM), months, now_basis (recent of month), now_from/now_to."},"market":{"type":"object","description":"electricity en gas (now_micro, median_micro, percentile; excl. btw) en household_year (now_cents, median_cents, percentile)."},"term_spread":{"type":"array","description":"Per contractvorm: form, label, provider, cheapest_monthly_cents, average_monthly_cents, difference_vs_fixed_1_year_monthly_cents, offers, is_estimate.","items":{"type":"object"}},"term_spread_basis":{"type":"string"},"computed_at":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"}}},"GridOperator":{"type":"object","properties":{"answer":{"type":"string"},"postcode":{"type":["string","null"]},"grid_operator":{"type":["object","null"],"description":"Stroom: slug, name, share (aandeel in het gebied, 0–1; null als opgegeven), derived_from."},"grid_operator_gas":{"type":["object","null"]},"connection":{"type":"string"},"gas_category":{"type":["string","null"]},"costs":{"type":"array","description":"Dit jaar en volgend jaar: per product year, category_label, per_year_cents, per_month_cents (incl. btw), per_year_excl_vat_cents, status (final/proposal), source_url.","items":{"type":"object"}},"connection_sizes":{"type":"array","items":{"type":"object"}},"notes":{"type":"array","items":{"type":"string"}},"operator_url":{"type":"string","format":"uri"},"compare_url":{"type":"string","format":"uri"}}},"PriceChanges":{"type":"object","properties":{"filters":{"type":"object"},"basis":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"headline":{"type":"string"},"provider":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}}},"product":{"type":"string"},"form_label":{"type":"string"},"kind":{"type":"string","enum":["change","new_product"]},"effective_date":{"type":["string","null"],"format":"date"},"upcoming":{"type":"boolean"},"detected":{"type":"string"},"direction":{"type":"string","enum":["up","down","flat","mixed"]},"diffs":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"old":{"type":"string"},"new":{"type":"string"},"pct":{"type":"string"},"direction":{"type":"string"}}}},"average_household":{"type":["object","null"],"description":"old_monthly_cents, new_monthly_cents, delta_monthly_cents (rekenkern), is_estimate, household."},"url":{"type":"string","format":"uri"},"provider_url":{"type":["string","null"],"format":"uri"}}}},"counts":{"type":"object"},"feed_url":{"type":"string","format":"uri"}}},"PriceHistory":{"type":"object","properties":{"subject":{"type":"string","enum":["stroom","gas","energiebelasting","day-ahead"]},"question":{"type":["string","null"]},"answer":{"type":["string","null"]},"headline":{"type":["string","null"]},"insight":{"type":["string","null"]},"columns":{"type":"object","additionalProperties":{"type":"string"},"description":"Kolom → omschrijving met eenheid en btw-basis."},"per_year":{"type":"array","items":{"type":"object"},"description":"Nieuwste eerst; per kolom *_micro (micro-euro per eenheid; belastingvermindering in reduction_cents) en de tekst."},"recent_months":{"type":"array","items":{"type":"object"}},"notes":{"type":"array","items":{"type":"string"}},"assumptions":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":["string","null"]},"note":{"type":["string","null"]}}}},"csv_url":{"type":["string","null"],"format":"uri"},"updated_at":{"type":["string","null"],"format":"date-time"}}},"EnergyTax":{"type":"object","properties":{"year":{"type":"integer"},"exact":{"type":"boolean","description":"false: tarieven van dat jaar nog niet bekend, die van het laatste bekende jaar."},"note":{"type":["string","null"]},"electricity":{"type":["object","null"]},"gas":{"type":["object","null"]}}}}},"security":[{},{"ApiKey":[]}]}