API | VEKA EnergieAttesten API |
|---|---|
Doel | Gegevens over een (historisch) ingediend energieprestatieattest opzoeken |
Locatie | Testomgeving: https://energie-ti-secure.api.vlaanderen.be/energie-attesten-api/v1/energie-attesten |
Toegang | Voor overheden, lokale besturen, … op basis van een vooraf afgesloten protocol (aanvraag: locatie aanvraagformulier) en ontsloten via een PKI-certificaat |
Technische informatie | (link naar github) |
| Inhoudsopgave |
|---|
Implementatie
Voor het ontvangen van specifieke gegevens van energieprestatieattesten (epb - aangifte, epc - bouw, epc - residentieel, epc - gemeendeel, epc - niet residentieel) kan men een opzoeking doen aan de hand van verplichte en optionele zoekcriteria.
Het zoekcriterium “Reden” is steeds verplicht en stemt overeen met het doeleinde van het gebruik van de API.
Daarnaast is ook minstens één van onderstaande hoofdzoekcriteria vereist:
...
Overzicht van de zoekcriteria
Veldnaam | Omschrijving | Toegelaten waarden | Veldtype |
gemeente | Gemeentenaam | String | |
straat | Straatnaam | String | |
huisnummer | Huisnummer | String | |
busnummer | Busnummer |
| String |
postcode | Postcode |
| ? |
energieAttestNummer | Uniek energie attestnummer | String | |
gebouwId | GebouwID uit het gebouwregister van de Vlaamse overheid | ? | |
gebouweenheidId | GebouwEenheidID uit het gebouwregister van de Vlaamse overheid | ? | |
datumIngediendVanaf | De vroegste indiendatum waarvoor een energieattest gezocht wordt | ||
geldig | Indictie of al dan niet enkel nog geldige energieattesten opgezocht mogen worden | Keuze:
| Boolean |
reden | |||
|
Overzicht van de antwoordvelden
Veldnaam | Omschrijving | Mogelijke waarden (indien van toepassing) |
id | unieke interne technische identificator van het energieattest | |
energieAttestNummer | unieke energieattestnummer zoals vermeld op het energieprestatiecertificaat of de aangifte | |
energieAttestStatus | status van het energieattest | ‘geldig’, ‘vervangen’, ‘vervallen’, Geannuleerd?, Ingetrokken?, Actief? of Inactief? |
datumIngediend | datum van indienen van het energieattest |
|
datumGeldigheid | datum tot wanneer het energieattest geldig is |
|
isEnergieAttestLaatstGeldige | indicatie of het betreffende energieattest het laatst geldende is overkoepelend alle subdomeinen | ‘true’ of ‘false’ |
energieAttestType | indicatie of het energieattest werd opgesteld in kader van bestaande bouw (EPC) of nieuwbouw/renovatie (EPC) | ‘EPC’ of ‘EPB’ |
hoofdBestemming | ‘residentieel’, ‘niet-residentieel’, ‘gemeenschappelijk deel’ of ‘gemengd’ | |
bestemming | ‘kantoor’, ‘handelszaak’, ‘hotel, b&b, …’, ‘restaurant, café, cafetaria’, ‘kleuter- of lager onderwijs’, ‘secundair onderwijs’, ‘hoger onderwijs’, ‘sporthal’, ‘zwembad’, ‘sport en recreatie - overige’, ‘ziekenhuis’, ‘woonzorgcentrum', ‘medische (groeps)praktijk’, ‘gezondheidszorg- en welzijnszorginstelling - overige’, ‘kinderdagverblijf of buitenlandse schoolopvang’, ‘wijkhuis/buurtcentrum’, ‘jeugdbeweging’, maatschappelijke dienstverlening - overige’, ‘bibliotheek’, ‘evenementenhal’, ‘museum’, ‘cinema’, ‘gebouw voor podiumkunsten’, ‘cultuur- of bijeenkomstgebouw - overige’, ‘luchthaven’, ‘postkantoor’, ‘gemeentehuis', ‘stationsgebouw’, ‘politiekantoor’, ‘brandweerkazerne’, ‘gerechtshof’, ‘gevangenis of instelling’, ‘openbare diensten - overige’, ‘andere’ | |
gebouwId | ||
gebouweenheidId | ||
adressen: adresId straat huisnummer gemeente postcode | Lijst van adressen gekoppeld aan het energieprestatiecertificaat, met per adres duiding van ‘adresId’, ‘gemeente’, ‘straat’, ‘huisnummer’, ('busnummer') en ‘postcode’ |
Voorbeelden van een request
...