Catalogus

Negen vragen die vandaag antwoord krijgen

Zes zijn een directe call; drie leidt u af uit een respons die u toch al ophaalt. Alle negen draaien op de live API, op beide toegangsvormen: een sleutel in de header voor uw eigen software, en dit portaal voor uw browser.

• A1

  Geef me de kerncijfers van deze buurt.

  Inwoners, woningvoorraad, gemiddelde woningwaarde, inkomen en de buurtpolygoon — CBS-kerncijfers zonder StatLine-OData te leren. De woningwaarde is een buurtgemiddelde, geen waarde per adres.

  GET /v1/buurten/{buurtcode}

  CBS wijk- en buurtstatistiek — peildatum ophalen… · ververst change-detectie

  Bron: CBS en Kadaster

  GET /v1/buurten/BU00140000
  X-Api-Key: <uw sleutel>
  
  {
    "peildatum": "2026-08-02",
    "feature": {
      "buurtcode": "BU00140000",
      "buurtnaam": "Binnenstad-Noord",
      "wijkcode": "WK001400",
      "gemeentecode": "GM0014",
      "gemeentenaam": "Groningen",
      "water": "NEE",
      "aantal_inwoners": 4745,
      "gemiddeld_inkomen_per_inwoner": null,
      "woningvoorraad": 2532,
      "gemiddelde_woningwaarde": 297,
      "geometry_wkt": "POLYGON((6.5670317 53.2223025, 6.5648018 53.2218529, … ))"
    }
  }

  Alleen de polygoon: die telt 22 punten en 489 tekens, waarvan hier de eerste twee staan. Twee velden zijn hier leeg omdat het CBS ze voor deze buurt niet publiceert — dat is een echte null en geen fout.

• A2

  Geef me alle buurtpolygonen voor mijn eigen kaart.

  GeoJSON in WGS84, 14.668 buurten in één respons. De herprojectie uit Rijksdriehoek en de vereenvoudiging zijn al gedaan — dat is waar iedereen op struikelt.

  GET /v1/buurten/geojson

  CBS wijk- en buurtstatistiek — peildatum ophalen… · ververst change-detectie

  Bron: CBS en Kadaster

  GET /v1/buurten/geojson
  X-Api-Key: <uw sleutel>
  
  {
    "type": "FeatureCollection",
    "peildatum": "2026-08-02",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [[[6.5670317, 53.2223025], [6.5648018, 53.2218529], … 22 punten ]]
        },
        "properties": {
          "aantal_inwoners": 4745,
          "buurtcode": "BU00140000",
          "buurtnaam": "Binnenstad-Noord",
          "gemeentecode": "GM0014",
          "gemeentenaam": "Groningen",
          "gemiddeld_inkomen_per_inwoner": null,
          "gemiddelde_woningwaarde": 297,
          "water": "NEE",
          "wijkcode": "WK001400",
          "woningvoorraad": 2532
        }
      },
      … 14.667 andere buurten
    ]
  }

  De respons telt 14.668 buurten en 17,3 MB. Hier staat de eerste, met zijn polygoon ingekort tot twee punten.

• A3

  Hoe is de energielabelverdeling in deze gemeente?

  Aantal en aandeel per labelklasse. Geteld zijn de geregistreerde labels; over woningen zónder registratie zegt deze respons niets — dat is A5.

  GET /v1/gemeenten/{gemeentecode}/energielabels

  Energielabels — peildatum ophalen… · ververst maandelijks totaalbestand

  Bron: EP-Online (RVO)

  GET /v1/gemeenten/GM0363/energielabels
  X-Api-Key: <uw sleutel>
  
  {
    "peildatum": "2026-08-02",
    "gemeentecode": "GM0363",
    "verdeling": [
      {"klasse": "A++++", "aantal": 1400, "percentage": 0.3649577952378221},
      {"klasse": "A+++", "aantal": 13107, "percentage": 3.4167870158443816},
      {"klasse": "A++", "aantal": 18904, "percentage": 4.927972972268421},
      {"klasse": "A+", "aantal": 26084, "percentage": 6.799685093559537},
      {"klasse": "A", "aantal": 115640, "percentage": 30.14551388664411},
      {"klasse": "B", "aantal": 53857, "percentage": 14.039665698659562},
      {"klasse": "C", "aantal": 77752, "percentage": 20.26871321095082},
      {"klasse": "D", "aantal": 37812, "percentage": 9.856988681094665},
      {"klasse": "E", "aantal": 18718, "percentage": 4.879485722329682},
      {"klasse": "F", "aantal": 9303, "percentage": 2.4251445493553283},
      {"klasse": "G", "aantal": 10949, "percentage": 2.854230642899225},
      {"klasse": "A+++++", "aantal": 80, "percentage": 0.020854731156446978}
    ],
    "totaal": 383606
  }

  Niets ingekort: dit is de volledige respons voor Amsterdam. De percentages zijn onafgerond zoals de API ze geeft, en de twaalf klassen staan in de volgorde waarin de respons ze levert — afronden en sorteren doet u zelf.

• A4

  Geef me het landelijke labelbeeld, alle gemeenten in één keer.

  Eén respons voor benchmarking of een eigen landkaart. Let op: er zitten meer gemeentecodes in dan er gemeenten zijn — historische codes verdwijnen niet uit een labelregistratie.

  GET /v1/energielabels

  Energielabels — peildatum ophalen… · ververst maandelijks totaalbestand

  Bron: EP-Online (RVO)

  GET /v1/energielabels
  X-Api-Key: <uw sleutel>
  
  {
    "peildatum": "2026-08-02",
    "total_count": 463,
    "gemeenten": [
      {
        "gemeentecode": "GM0363",
        "peildatum": "2026-08-02",
        "totaal": 383606,
        "verdeling": [ … twaalf klassen, zoals in A3 … ]
      },
      … 462 andere gemeentecodes
    ]
  }

  De respons telt 463 gemeentecodes en 367 KB. Hier staat er één, met zijn verdeling ingekort. Nederland heeft vandaag 342 gemeenten: het verschil zijn codes die in de labelregistratie zijn achtergebleven, en dat is de reden dat wij hier de codes tellen en niet de gemeenten.

• A5

  Hoe groot is de verduurzamingsopgave in deze buurt — hoeveel woningen, welk deel gelabeld, welk deel E/F/G?

  Drie getallen per buurt, alle drie afgeleid en geen ervan overgeschreven: de woningvoorraad uit de gebouwenregistratie, de labeldekking daarop, en het E/F/G-aandeel binnen het gelabelde deel.

  GET /v1/verduurzaming/{buurtcode}

  BAG verblijfsobjecten — peildatum ophalen… · ververst maandelijks (9e)

  Bron: Kadaster · EP-Online (RVO) · CBS en Kadaster

  GET /v1/verduurzaming/BU00140000
  X-Api-Key: <uw sleutel>
  
  {
    "peildatum": "2026-08-09",
    "buurt": {
      "buurtcode": "BU00140000",
      "buurtnaam": "Binnenstad-Noord",
      "wijkcode": "WK001400",
      "gemeentecode": "GM0014",
      "gemeentenaam": "Groningen",
      "woningen": 2533,
      "gelabeld": 1882,
      "efg_woningen": 305,
      "dekking_pct": 74.3,
      "efg_pct_van_gelabeld": 16.2
    }
  }

• A6

  Geef me de opgave voor heel Nederland en laat mij zelf sorteren.

  14.153 buurten in één respons — klein genoeg om zelf te aggregeren, groot genoeg om niet zelf te bouwen. De 515 buurten zonder woningen ontbreken; ze staan er niet op nul.

  GET /v1/verduurzaming

  BAG verblijfsobjecten — peildatum ophalen… · ververst maandelijks (9e)

  Bron: Kadaster · EP-Online (RVO) · CBS en Kadaster

  GET /v1/verduurzaming
  X-Api-Key: <uw sleutel>
  
  {
    "peildatum": "2026-08-09",
    "total_count": 14153,
    "buurten": [
      {
        "buurtcode": "BU00140000",
        "buurtnaam": "Binnenstad-Noord",
        "wijkcode": "WK001400",
        "gemeentecode": "GM0014",
        "gemeentenaam": "Groningen",
        "woningen": 2533,
        "gelabeld": 1882,
        "efg_woningen": 305,
        "dekking_pct": 74.3,
        "efg_pct_van_gelabeld": 16.2
      },
      … 14.152 andere buurten
    ]
  }

  De respons telt 14.153 buurten en 3,2 MB. Hier staat de eerste.

Drie die u zelf uit een respons haalt

Voor deze drie bouwen wij geen eigen endpoint. Ze volgen uit een respons die u al heeft, en een tweede endpoint zou een tweede waarheid over hetzelfde cijfer zijn. De resultaten hieronder zijn echt uitgerekend over de opgehaalde respons.

• A7

  Zet me dat om naar gemeenteniveau.

  Elke buurtregel draagt gemeentecode en gemeentenaam, dus de roll-up naar 342 gemeenten doet uw eigen code in milliseconden. Wij bouwen daar geen tweede endpoint voor: dat zou een tweede waarheid over hetzelfde cijfer zijn.

  afgeleid uit GET /v1/verduurzaming

  BAG verblijfsobjecten — peildatum ophalen… · ververst maandelijks (9e)

  Bron: Kadaster · EP-Online (RVO) · CBS en Kadaster

  GET /v1/verduurzaming
  X-Api-Key: <uw sleutel>
  
  // eigen code: groepeer de A6-respons op gemeentecode → 342 gemeenten
  [
    {"gemeentecode": "GM0606", "gemeentenaam": "Schiedam", "woningen": 38681, "gelabeld": 25262, "dekking_pct": 65.3, "efg_woningen": 4905, "efg_pct_van_gelabeld": 19.4},
    {"gemeentecode": "GM0363", "gemeentenaam": "Amsterdam", "woningen": 494416, "gelabeld": 357091, "dekking_pct": 72.2, "efg_woningen": 35477, "efg_pct_van_gelabeld": 9.9},
    {"gemeentecode": "GM0034", "gemeentenaam": "Almere", "woningen": 95870, "gelabeld": 64523, "dekking_pct": 67.3, "efg_woningen": 49, "efg_pct_van_gelabeld": 0.1},
    … 339 andere gemeenten
  ]

  Drie van de 342 gemeenten, uitgerekend over de volledige A6-respons. Schiedam 19,4% en Almere 0,1%: dat zijn de kopcijfers van onze eigen verduurzamingsanalyse, hier gereproduceerd zonder één extra endpoint.

• B1

  Welke buurten hebben de grootste opgave én de laagste labeldekking — waar moet ik als eerste heen?

  Ranking op twee velden uit dezelfde respons: woningvoorraad × ontbrekende dekking. Acquisitiesturing zonder extra call.

  afgeleid uit GET /v1/verduurzaming

  BAG verblijfsobjecten — peildatum ophalen… · ververst maandelijks (9e)

  Bron: Kadaster · EP-Online (RVO)

  GET /v1/verduurzaming
  X-Api-Key: <uw sleutel>
  
  // eigen code: sorteer de A6-respons op woningen × (100 − dekking_pct)
  // hier: buurten met minstens 500 woningen
  [
    {"buurtcode": "BU05991289", "buurtnaam": "Groot IJsselmonde", "gemeentenaam": "Rotterdam", "woningen": 14417, "dekking_pct": 75.4, "zonder_label": 3547},
    {"buurtcode": "BU05991463", "buurtnaam": "Ommoord", "gemeentenaam": "Rotterdam", "woningen": 13179, "dekking_pct": 74.7, "zonder_label": 3334},
    {"buurtcode": "BU05183284", "buurtnaam": "Leyenburg", "gemeentenaam": "'s-Gravenhage", "woningen": 8458, "dekking_pct": 65.4, "zonder_label": 2926},
    {"buurtcode": "BU05991699", "buurtnaam": "Hoogvliet Zuid", "gemeentenaam": "Rotterdam", "woningen": 10918, "dekking_pct": 73.2, "zonder_label": 2926},
    … 5.652 andere buurten die de drempel halen
  ]

  5.656 van de 14.153 buurten halen de drempel van 500 woningen; hier staan de bovenste vier. Die drempel staat in de code hierboven en niet in de data: zonder drempel staan er kleine buurten bovenaan waar één blok het verschil maakt.

• B5

  Hoeveel woningen zónder geregistreerd label staan er in dit gebied?

  Woningen minus gelabeld, per buurt of landelijk opgeteld. Landelijk gaat het om ruim drie miljoen woningen — dat is de teller waar een labelaar of energieadviseur zijn markt op plant.

  afgeleid uit GET /v1/verduurzaming

  BAG verblijfsobjecten — peildatum ophalen… · ververst maandelijks (9e)

  Bron: Kadaster · EP-Online (RVO)

  GET /v1/verduurzaming
  X-Api-Key: <uw sleutel>
  
  // eigen code: tel de A6-respons op
  {
    "woningen": 8321075,
    "gelabeld": 5241189,
    "zonder_geregistreerd_label": 3079886,
    "dekking_pct": 63,
    "efg_woningen": 527574
  }

  Opgeteld over alle 14.153 buurten in de A6-respons. "Zonder geregistreerd label" betekent precies dat: er is geen label geregistreerd. Het zegt niets over of een woning ooit een label had.