1 Opzoekingsmogelijkheden

Opzoekingsmogelijkheden

Voor het ontvangen van specifieke gegevens van energieprestatieattesten epc - niet residentieel ((epb - aangifte, epc - bouw, epc - residentieel, epc - gemeendeel en epc klein niet residentieel volgens later) kan men een opzoeking doen aan de hand van verplichte en optionele zoekcriteria.

Daarnaast is ook minstens één van onderstaande hoofdzoekcriteria vereist:

energieAttestNummer
Adres (minimaal gemeente, straat en huisnummer
GebouwID
GebouweenheidID

Naast deze vereiste zoekcriteria, kunnen andere optionele zoekcriteria toegevoegd worden. Op basis van het vastgelegde protocol met het VEKA kan het zijn dat bepaalde optionele zoekcriteria toch verplicht worden. Bij configuratie van de aansluiting zal dit duidelijk meegedeeld worden.

Door het toepassen van de verplichte en optionele zoekcriteria wordt de response beperkt en krijg je als afnemer enkel de energieprestatiecertificaten terug die voldoen aan alle opgegeven zoekcriteria.

Wanneer geen enkel certificaat voldoet aan je zoekcriteria, krijg je als afnemer een leeg resultaat terug.

Overzicht van de zoekcriteria

Veldnaam	Omschrijving	Toegelaten waarden
gemeente	Gemeentenaam
straat	Straatnaam
huisnummer	Huisnummer
busnummer	Busnummer
postcode	Postcode
energieAttestNummer	Uniek energie attestnummer
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: True False

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’
datumIngediend	datum van indienen van het energieattest
datumGeldigheid	datum tot wanneer het energieattest geldig is
energieAttestType	indicatie of het energieattest werd opgesteld in kader van bestaande bouw (EPC) of nieuwbouw/renovatie (EPC)	‘EPC’ of ‘EPB’
hoofdBestemming	de hoofdbestemming van de eenheid waarvoor het energieattest werd opgesteld	‘residentieel’, ‘niet-residentieel’, ‘gemeenschappelijk deel’ of ‘gemengd’
bestemming	de gedetailleerde bestemming van de eenheid waarvoor het energieattest werd opgesteld	‘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	de gebouw_id van het gebouwenregister waaraan het energieattest is gekoppeld
gebouweenheidId	de gebouweenheid_id van het gebouwenregister waaraan het energieattest is gekoppeld
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’
detail	verwijzing naar het detail van het energieattest

Voorbeelden van een request

https://energie-ti-secure.api.vlaanderen.be/energie-attesten-api/v1/energie-attesten?energieAttestNummer=20230607-0010115737-NR-3

https://energie-ti-secure.api.vlaanderen.be/energie-attesten-api/v1/energie-attesten?gemeente=zoersel&straat=zandstraat&huisnummer=99

Voorbeeld van response

Succesvolle opzoeking (zie ref naar pagina beschrijving detail energieattest )

HTTP Code: 200
Response: Bevestiging en uniek VEKA meldingsnummer

[
    {
        "id": "dbabf3c0-1b31-40dc-9392-b7251776f99a",
        "energieAttestNummer": "20230607-0010115737-NR-3",
        "energieAttestStatus": "geldig",
        "datumIngediend": "2023-06-07",
        "datumGeldigheid": "2028-06-07",
        "energieAttestType": "EPC",
        "hoofdBestemming": "niet-residentieel",
        "bestemming": "lager onderwijs",
        "adressen": [
            {
                "straat": "Zandstraat",
                "huisnummer": "99",
                "gemeente": "Zoersel",
                "postcode": "2980",
                "adresId": "11667839"
            }
        ],
        "gebouweenheidId": "101157379",
        "gebouwId": "101148109",
        "detail": {
            "id": "dbabf3c0-1b31-40dc-9392-b7251776f99a",
            "url": "https://energie-ti-secure.api.vlaanderen.be/energie-attesten-api/v1/energie-attesten/dbabf3c0-1b31-40dc-9392-b7251776f99a"
        }
    }
]

Technische Documentatie VEKA

Zoek EnergieAttesten API