Hvad fortæller ét opslag om en ejendom?

Hvad der er med i ét kald

{
  "bfe_nummer": 5651067,
  "kommunekode": "0740",
1  "dagi": {
1    "kommune": { "kode": "0740", "navn": "Silkeborg" },
1    "region": { "kode": "1082", "navn": "Region Midtjylland" }
  },
2  "jordstykke": { "matrikelnummer": "138o", "ejerlav_kode": 2006552, "ejerlav_navn": "Silkeborg Markjorder" },
3  "antal_bygninger": 3,
3  "hovedbygning_index": 2,
3  "bygninger": [ … ],
4  "vurdering": {
4    "antal_vurderingsejendomme": 1,
4    "seneste": { "aar": 2024, "ejendomsvaerdi_kr": 2596000, "grundvaerdi_kr": 1702000, "vurderet_areal_m2": 460 },
4    "historik": [ { "aar": 2024, … }, { "aar": 2022, … } ]
  }
}

Først BFE-nummeret

Opslaget tager et BFE-nummer. Starter du med en adresse, er der ét kald før: /v1/adresse/search giver bfe_nummer på hvert hit. Starter du med et kundekartotek, så vask adresserne med datavask, som også giver BFE-nummeret. Ærligt talt er det altså to kald fra adresse til komplet ejendom — men kun ét pr. ejendom, når du har nøglen.

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

curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Læs vurderingen rigtigt

vurdering har tre tilstande, og de betyder hver sit. Mangler feltet, er vurderingen ikke slået op — fx ved et opslag med asOf, hvor dagens vurdering ikke hører hjemme. Er det null, blev den slået op, men der er intet at vise: ejendommen har ingen vurdering, eller registret kunne ikke læses. Er det et objekt, så læs antal_vurderingsejendomme før seneste.

Hvad der ikke er med

Svaret er det, registrene ved om ejendommen. Geometri, højder og arealbindinger er separate opslag, fordi de koster et kald mod andre kilder, og de fleste integrationer ikke skal bruge dem:

• Jordstykkernes omrids: /v1/matrikel/ejendom/:bfe. Bygningernes omrids: /v1/geodanmark/bygninger/:bfe. I ejendomssvaret har hver bygning kun et punkt.
• Byggelinjer og § 3: /v1/natur/byggelinjer på et koordinat.
• Terræn og bygningshøjder: /v1/dhm/punkt og /v1/dhm/bygninger/:bfe.
• Sogn, retskreds og politikreds: /v1/dagi/reverse — se guiden.
• Ejeroplysninger udleveres ikke.

Når kilden er nede

Svaret samles fra Datafordeler, som ikke altid svarer. Findes der en cachet kopi af ejendommen, får du den med headeren X-Grundfast-Stale: true, så din berigelse ikke går i stå. Gem headeren sammen med resultatet, hvis det betyder noget for dig, hvor frisk det er. Findes der ingen kopi, svarer endpointet 502, og kaldet lægges tilbage i kvoten. I et batch-svar står det pr. ejendom som stale: true. Se Svar, null og friskhed.

Mange ejendomme

Til en liste bruger du POST /v1/bbr/ejendom:batch med op til 50 BFE-numre pr. kald (Pro). Ejendomme, der fejler, lander i errors med deres egen status, mens resten svarer normalt. Til tusinder er der eksport (Scale), som henter op til 5.000 ejendomme som ét job og leverer CSV, NDJSON eller GeoJSON. Hver ejendom tæller én enhed uanset vej.