Energielabels V3 API documentatie

Doorzoek de dataset van de ep-online waarin alle energielabels en energieprestatie-indicatoren van gebouwen zijn opgenomen. De reponse bevat een lijst van gebouwen met hun bijbehorende energielabel. De dataset wordt 1 keer per dag bijgewerkt met mutaties. Een volledige sync met de bron gebeurd op de eerste dag van de maand.

API Overzicht

GET	`https://api.overheid.io/v3/energielabels`
GET	`https://api.overheid.io/v3/energielabels/{id}`
GET	`https://api.overheid.io/v3/geo/energielabels/radius/{lat}/{lon}/{radius}`
GET	`https://api.overheid.io/v3/geo/energielabels/around/{id}/{radius}`
GET	`https://api.overheid.io/v3/geo/energielabels/box/{tlLat}/{tlLon}/{brLat}/{brLon}`

API endpoints

GET	`https://api.overheid.io/v3/energielabels`

Parameters

Naam	Standaard waarde	Omschrijving
size	100	Het aantal resultaten per pagina.
page	1	De gewenste pagina van resultaten.
fields[]	energieKlasse postcode huisNummer huisnummerToevoeging huisnummerLetter	Velden in het overzicht (indien aanwezig).
filters[]	Filter velden resulaten op termen. Dit is handig voor het filteren van vaste waardes, zoals bijvoorbeeld postcode.
query		Zoek naar waarde.
queryfields	postcode huisNummer	Zoek naar waarde in deze velden.
exists		Zorg dat dit veld in de resultaten aanwezig is.

Voor de fields[] en filters[] array kun je alle veldnamen opgeven die in het details over een energielabel aanwezig zijn.

Voorbeelden

Zoek op postcode

https://api.overheid.io/v3/energielabels?filters[postcode]=7544HC

{
  "totalItemCount": 13,
  "pageCount": 1,
  "size": 100,
  "_links": {
    "self": {
      "href": "\/v3\/energielabels?query=7544HC&page=1"
    }
  },
  "_embedded": {
    "energielabel": [
      {
        "postcode": "7544HC",
        "energieKlasse": "A",
        "huisNummer": 13,
        "slug": "153010000298161-7544hc-13",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/153010000298161-7544hc-13"
          }
        }
      },
      {
        "postcode": "7544HC",
        "energieKlasse": "B",
        "huisNummer": 6,
        "slug": "153010000451929-7544hc-6",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/153010000451929-7544hc-6"
          }
        }
      },
      {
        "postcode": "7544HC",
        "energieKlasse": "B",
        "huisNummer": 2,
        "slug": "153010000411139-7544hc-2",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/153010000411139-7544hc-2"
          }
        }
      },
      ...
    ]
  }
}

Geef alle energielabels terug met een postcode beginnend met 1156* en toon de certificaathouder in het overzicht

https://api.overheid.io/v3/energielabels?query=1156*&fields[]=certificaathouder

{
  "totalItemCount": 455,
  "pageCount": 5,
  "size": 100,
  "_links": {
    "self": {
      "href": "\/v3\/energielabels?query=1156*&fields[0]=certificaathouder&page=1"
    },
    "next": {
      "href": "\/v3\/energielabels?query=1156*&fields[0]=certificaathouder&page=2"
    },
    "first": {
      "href": "\/v3\/energielabels?query=1156*&fields[0]=certificaathouder&page=1"
    },
    "last": {
      "href": "\/v3\/energielabels?query=1156*&fields[0]=certificaathouder&page=10"
    }
  },
  "_embedded": {
    "energielabel": [
      {
        "certificaathouder": "Energie Inspectie B.V.",
        "postcode": "1156AL",
        "energieKlasse": "C",
        "huisNummer": 17,
        "slug": "852010000002348-1156al-17",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/852010000002348-1156al-17"
          }
        }
      },
      {
        "certificaathouder": "Duurzaam Check B.V.",
        "postcode": "1156BC",
        "energieKlasse": "G",
        "huisNummer": 27,
        "slug": "852010000002049-1156bc-27",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/852010000002049-1156bc-27"
          }
        }
      },
      {
        "certificaathouder": "Energie Inspectie B.V.",
        "postcode": "1156BA",
        "energieKlasse": "C",
        "huisNummer": 13,
        "slug": "852010000002020-1156ba-13",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/852010000002020-1156ba-13"
          }
        }
      },
      {
        "certificaathouder": "BuildingLabel B.V.",
        "postcode": "1156BG",
        "energieKlasse": "G",
        "huisNummer": 10,
        "slug": "852010000001788-1156bg-10",
        "_links": {
          "self": {
            "href": "\/v3\/energielabels\/852010000001788-1156bg-10"
          }
        }
      },
      ...
    ]
  }
}

GET	`https://api.overheid.io/v3/energielabels/{id}`

Geef alle informatie van een energielabel

https://api.overheid.io/v3/energielabels/164010000001167-7551dc-20-i

{
  "berekeningType": "NTA 8800:2023 (basisopname utiliteitsbouw)",
  "bagVerblijfsobjectId": 164010000001167,
  "huisNummer": 20,
  "berekendeCO2Emissie": 67.83,
  "compactheid": 1.74,
  "certificaathouder": "Prosperos B.V.",
  "gebouwKlasse": "U",
  "warmteBehoefte": 183,
  "geldigTot": "20340214",
  "primaireFossieleEnergie": 354.52,
  "energieBehoefte": 208.24,
  "slug": "164010000001167-7551dc-20-i",
  "updatedAt": "2024-10-11",
  "primaireFossieleEnergieEmgForfaitair": 354.52,
  "locatie": {
    "lon": 6.79441425,
    "lat": 52.26309535
  },
  "soortOpname": "Basisopname",
  "gebruiksoppervlakteThermischeZone": 546.47,
  "aandeelHernieuwbareEnergie": 0,
  "registratieDatum": "20240305",
  "postcode": "7551DC",
  "temperatuurOverschrijding": 0,
  "huisNummerToevoeging": "I",
  "bagPandIds": [
    164100000014679
  ],
  "opnameDatum": "20240214",
  "opBasisVanReferentieGebouw": false,
  "berekendeEnergieverbruik": 336.72,
  "energieKlasse": "G",
  "bouwjaar": 1930,
  "status": "Bestaand",
  "_links": {
    "self": {
      "href": "\/v3\/energielabels\/164010000001167-7551dc-20-i"
    }
  }
}

GET	`https://api.overheid.io/v3/geo/energielabels/radius/{lat}/{lon}/{radius}`

Geef alle energielabel om een locatie heen met een bepaalde radius in meters. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/energielabels/radius/51.90465775/6.37526369/1000

Paginering, filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.36941227,
          51.89756122
        ]
      },
      "properties": {
        "postcode": "7071EB",
        "energieKlasse": "A",
        "huisNummer": 3,
        "slug": "1509010000217192-7071eb-3"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37806034,
          51.89868202
        ]
      },
      "properties": {
        "postcode": "7071AJ",
        "energieKlasse": "C",
        "huisNummer": 53,
        "slug": "1509010000216514-7071aj-53"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37016486,
          51.89777138
        ]
      },
      "properties": {
        "postcode": "7071JP",
        "energieKlasse": "C",
        "huisNummer": 30,
        "slug": "1509010000216538-7071jp-30"
      }
    },
    ...
  ]
}

GET	`https://api.overheid.io/v3/geo/energielabels/around/{id}/{radius}`

Geef alle energielabel om een bestaande energielabel heen met een bepaalde radius in meters. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/energielabels/around/1509010000217192-7071eb-3/100

Gebruik voor het {id} de `slug` van energielabel. Filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.36941227,
          51.89756122
        ]
      },
      "properties": {
        "postcode": "7071EB",
        "energieKlasse": "A",
        "huisNummer": 3,
        "slug": "1509010000217192-7071eb-3"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37806034,
          51.89868202
        ]
      },
      "properties": {
        "postcode": "7071AJ",
        "energieKlasse": "C",
        "huisNummer": 53,
        "slug": "1509010000216514-7071aj-53"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.37016486,
          51.89777138
        ]
      },
      "properties": {
        "postcode": "7071JP",
        "energieKlasse": "C",
        "huisNummer": 30,
        "slug": "1509010000216538-7071jp-30"
      }
    },
    ...
  ]
}

GET	`https://api.overheid.io/v3/geo/energielabels/box/{tlLat}/{tlLon}/{brLat}/{brLon}`

Geef alle energielabel in een box. Je geeft daarbij de TopLeft (tlLat,tlLon) en de RightBottom (rbLat, rbLon) coördinaten mee in de request. De response is een GeoJSON object, zodat je die eventueel direct in kaarten kan gebruiken.

https://api.overheid.io/v3/geo/energielabels/box/51.91029693438848/6.38548415524967/51.90715962775278/6.3942066985473955

Filtering etc werkt gewoon zoals in de niet geoJSON APIs die hierboven staan beschreven.

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.39055118,
          51.90996382
        ]
      },
      "properties": {
        "postcode": "7064CN",
        "energieKlasse": "C",
        "huisNummer": 19,
        "slug": "1509010000216946-7064cn-19"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38740867,
          51.91003457
        ]
      },
      "properties": {
        "postcode": "7064EZ",
        "energieKlasse": "B",
        "huisNummer": 1,
        "slug": "1509010000216956-7064ez-1"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38682731,
          51.91026325
        ]
      },
      "properties": {
        "postcode": "7064GA",
        "energieKlasse": "D",
        "huisNummer": 19,
        "slug": "1509010000215606-7064ga-19"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          6.38760813,
          51.9099588
        ]
      },
      "properties": {
        "postcode": "7064EZ",
        "energieKlasse": "C",
        "huisNummer": 5,
        "slug": "1509010000216174-7064ez-5"
      }
    },
   ...
  ]
}