Hvor stor er boligen, og hvornår er den bygget?

To kald: adresse → BFE → bygninger

Først slår du adressen op med /v1/adresse/search. Hvert hit har bfe_nummer: BFE-nummeret på den ejendom, som jordstykket under adressens adgangspunkt hører til. Det tal sender du til /v1/bbr/ejendom/:bfe, som giver alle bygninger på ejendommen med areal, årstal og materialer.

# 1) Adressen → BFE-nummer
curl -G "https://api.grundfast.dk/v1/adresse/search" \
  --data-urlencode "q=Solbakkevej 70, 8600" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

# 2) BFE-nummeret → bygningerne med areal og årstal
curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Læs hovedbygningen, ikke den første bygning

En ejendom har ofte flere bygninger: huset, en garage, en carport, et udhus. Rækkefølgen i bygninger siger ikke noget om, hvilken der er boligen, og rigtige BBR-ejendomme indeholder også tomme poster uden areal og årstal. Brug derfor hovedbygning_index, som peger på den bygning med det største samlede bygningsareal. Er det null, har ingen af bygningerne et kendt areal.

{
  "bfe_nummer": 5651067,
  "antal_bygninger": 3,
2  "hovedbygning_index": 2,
  "bygninger": [
1    { "anvendelse": { "kode": "120", "tekst": "Fritliggende enfamiliehus" }, "opfoerelsesaar": null, "areal": { "bebygget_m2": null } },
    { "anvendelse": { "kode": "920", "tekst": "Carport" }, "opfoerelsesaar": 2014, "areal": { "bebygget_m2": 25 } },
    {
      "anvendelse": { "kode": "120", "tekst": "Fritliggende enfamiliehus" },
3      "opfoerelsesaar": 1958,
      "om_tilbygningsaar": null,
      "antal_etager": 1,
      "areal": {
        "bebygget_m2": 116,
        "samlet_bygningsareal_m2": 116,
3        "samlet_boligareal_m2": 95,
        "samlet_erhvervsareal_m2": null
      },
      "etager": { "kaelder_m2": 45, "udnyttet_tagetage_m2": null }
    }
  ]
}

Hvilket areal er hvilket

Et boligareal er ikke det samme som det bebyggede areal: et hus i to etager har et boligareal, der er større end fodaftrykket, og kælderen tæller ikke med i boligarealet. Skal du vise arealet for én lejlighed, så brug enhedens areal.samlet_m2 — se Hvilke boliger og lokaler er der på adressen?.

Opførelsesår og om-/tilbygningsår

opfoerelsesaar er det år, bygningen blev opført. om_tilbygningsaar er året for den seneste større om- eller tilbygning — BBR registrerer det kun, når arbejdet har en vis størrelse, så et nyt køkken giver ikke et nyt årstal. Feltet er derfor "seneste større ombygning", ikke "seneste ændring". Se også begrebet opførelsesår.

Når et felt er null

null betyder, at registret ikke har en værdi — ikke at værdien er nul. En bygning uden boligareal kan være en garage, men det kan også være et hus, hvor arealet aldrig er indberettet. Er etager selv null, er etage-opslaget ikke kørt, og du kan ikke slutte, at bygningen ikke har en kælder. Vis "ikke registreret" i stedet for et tal, du har gættet. Og læg ikke arealer sammen på tværs af bygninger uden at se på anvendelsen: en carport og et udhus har bebygget areal, men intet boligareal.

Har du mange adresser, så slå BFE-numrene op i ét kald med batch i stedet for ét ad gangen. Og vil du se, hvordan arealet var registreret på en bestemt dato, så brug asOf — se Historik og asOf.