BBR-API — hele ejendommen i ét kald
Grundfast genudstiller Bygnings- og Boligregistret (BBR) i den bekvemme gamle services.datafordeler.dk-form: bygninger, enheder, oversatte kodelister, materialer og varme — joinet på BFE-nummeret og leveret current-only i WGS84. Det er live nu som Register #1, og datakontrakten kan du teste uden nøgle.
GET /v1/bbr/ejendom/:bfePrøv BBR live
Kør det nøglefrie /v1/demo/ejendom og se en rigtig ejendom foldet ud — bygninger, arealer, materialer og oversatte kodelister, med rigtig svartid.
Vejleby By, Vester Hassing
Matr. 4a · BFE 5651067 · kommune 0851
Hvad BBR-API’et giver dig
Oversatte kodelister
BBR-koderne for anvendelse, ydervæg, tagdækning og varme oversættes til læsbar dansk tekst — ikke rå tal som "120" og "5".
Hele ejendommen i ét kald
Ét opslag på BFE-nummeret giver alle bygninger og enheder samlet — areal, opførelsesår, materialer, varme — joinet på tværs af BBR-entiteterne.
WGS84-geometri
Bygningernes koordinater reprojiceres fra EPSG:25832 til WGS84 og leveres som GeoJSON — direkte brugbar på et kort.
SLA-mirror & retry
Datafordeler kører ~90% oppetid med 401-flaps. Vi cacher og retry’er, så BBR-opslag er stabile i stedet for ustabile.
antal_etager → højde
BBR-feltet antal_etager koblet til GeoDanmarks bygningspolygon giver dig bygningen i 3D — rejst efter sit etageantal. Ren SVG, ingen kort-SDK. Samme join, du får i ét kald.
BBR API — bygninger og enheder på BFE
Ét BBR API-kald på BFE-nummeret returnerer hele ejendommen: alle bygninger med areal, opførelsesår, oversat anvendelse og materialer, og enhederne i hver bygning — joinet på tværs af BBR-entiteterne, current-only og i WGS84. Du slipper for selv at følge connections og cursors i Datafordelers GraphQL-backend.
Kald BBR-API’et i din stack
Endpointet er GET /v1/bbr/ejendom/:bfe med en gf_live_-nøgle. Request øverst, svaret nedenfor:
curl -H "Authorization: Bearer gf_live_xxx" \ "https://api.grundfast.dk/v1/bbr/ejendom/5651067"
Svaret har den endelige datakontrakt — samme form som den nøglefrie /v1/demo/ejendom:
# Live nu — Register #1 (Bearer gf_live_…): GET /v1/bbr/ejendom/5651067 → 200 { type: "ejendom", bfe_nummer: 5651067, bygninger: [{ anvendelse: { kode: "120", tekst: "Fritliggende enfamiliehus" }, opfoerelsesaar: 1972, om_tilbygningsaar: 2004, materialer: { ydervaeg: { tekst: "Mursten" }, tag: { tekst: "Tegl" } }, fredning: { fredet: false, status_tekst: "vurderet", bevaringsvaerdi: 4, kilde: "fbb" }, enheder: [ … ] }], … } # Datakontrakten virker uden nøgle: GET /v1/demo/ejendom → 200 { type: "ejendom", … }
Felter i svaret
| Felt | Type | Beskrivelse |
|---|---|---|
| bfe_nummer | number | Ejendommens BFE-nummer (Det Bestemte Faste Ejendoms-nummer) — indgangen til hele ejendommen. |
| type | string | Ressourcetypen — altid "ejendom" for dette opslag. |
| bygninger[] | Bygning[] | Alle bygninger på ejendommen, joinet fra BBR — hver med areal, år, materialer og enheder. |
| bygninger[].anvendelse | { kode, tekst } | BBR-anvendelseskoden plus den oversatte danske tekst, fx "120" → "Fritliggende enfamiliehus". |
| bygninger[].opfoerelsesaar | number | Bygningens opførelsesår fra BBR. |
| bygninger[].om_tilbygningsaar | number | null | Året for bygningens seneste VÆSENTLIGE om- eller tilbygning (BBR felt 209). BBR registrerer det først, når forbedringen udgør mindst 15 % af bygningens værdi før arbejdet — nyt køkken eller bad tæller ikke. null når året ikke er registreret; værdien leveres rå, så BBR’s pladsholdere 0 og 1000 forekommer. |
| bygninger[].fredning | { fredet, bevaringsvaerdi, … } | null | Om bygningen er FREDET (Slots- og Kulturstyrelsen) og dens SAVE-bevaringsværdi 1-9, hvor 1 er højest — joinet fra FBB på bygningens eget id. Ingen af delene står i BBR, og det er netop pointen: det er dét, der afgør, om bygningen overhovedet må rives ned eller ændres. Vigtigt: hele objektet er null, når vi ikke kan svare for bygningen (ingen FBB-række, eller opslaget kunne ikke gennemføres) — null er IKKE det samme som fredet: false. bevaringsvaerdi er null, når bygningen ikke er vurderet; FBB’s pladsholdere -1 og 0 er oversat til null, så de aldrig kan vises som "bevaringsværdi 0". En fredet bygning har ofte ingen SAVE-værdi — fredning er ikke en SAVE-karakter. Svaret bærer ingen dom: "bevaringsværdig" er en grænse på SAVE-værdien, som KOMMUNEN fastsætter. |
| bygninger[].materialer | { ydervaeg, tag } | Ydervægsmateriale og tagdækning — oversat til læsbar tekst ("Mursten", "Tegl"), ikke rå koder. |
| bygninger[].enheder[] | Enhed[] | Enhederne (boliger/erhverv) i bygningen, joinet med i samme svar. |
Parametre
| Parameter | Type | Beskrivelse |
|---|---|---|
| :bfe | number (sti) | Påkrævet. BFE-nummeret på den ejendom, du vil slå op. |
| asOf | string (query) | Valgfri YYYY-MM-DD — hent ejendommen som den var på en skæringsdato (se Historik-API’et). |
BBR: Grundfast vs. DAWA vs. rå Datafordeler
| Funktion | Grundfast | DAWA | Rå Datafordeler |
|---|---|---|---|
| Bygninger + enheder på BFE i ét kald | Ja | Nej | Nej |
| Oversatte kodelister (anvendelse, materialer, varme) | Ja | Nej | Nej |
| WGS84-bygningsgeometri (GeoJSON) | Ja | Nej | EPSG:25832 |
| Current-only — bitemporal støj fjernet | Ja | Nej | Nej |
| BBR-historik med ?asOf= | Ja | Nej | rå tid |
| Cachet SLA-mirror & retry | Ja | Nej | Nej |
Hvornår skal du bruge BBR-API’et
Ejendomsvurdering & valuering
Byg værdiansættelsen på boligareal, opførelsesår og anvendelse direkte fra BBR — hentet på BFE-nummeret, uden manuelt at joine bygning, enhed og grund.
Forsikring & risikovurdering
Tagdækning, ydervægsmateriale og opførelsesår — oversat til læsbar tekst — giver et risikogrundlag pr. bygning uden at slå rå BBR-koder op i en kodeliste.
Due diligence & mæglere
Fold hele ejendommen ud i ét kald: alle bygninger og enheder samlet, så handels- og udbudsflows har det fulde billede med det samme.
Kort & planlægning
Kobl antal_etager til GeoDanmarks bygningspolygon og få bygningen i WGS84 — klar til at tegne på kort eller rejse i 3D efter etageantal.
/v1/bbr/ejendom/:bfeBFE-nummer → alle bygninger og enheder joinet sammen, med oversatte kodelister. Klar at kalde nu.
/v1/demo/ejendomDemo-datakontrakten i den endelige form — virker uden nøgle.
Kom i gang med BBR
Opret en gratis nøgle i dashboardet og kald /v1/bbr/ejendom/:bfe.
Se også
Ofte stillede spørgsmål
Hvad er et BBR API?
Et API til Bygnings- og Boligregistret (BBR) — bygninger, enheder, anvendelse, areal, materialer og varme. Grundfast genudstiller BBR i den bekvemme gamle services.datafordeler.dk-form: oversatte kodelister, gensammensatte navne, current-only og WGS84, oven på Datafordelers nye entitetsmodel.
Er BBR-API’et live nu?
Ja. GET /v1/bbr/ejendom/:bfe er live som Register #1, verificeret mod rigtige BBR-ejendomme. Demo (/v1/demo/ejendom) virker uden nøgle, så du kan se den endelige datakontrakt med det samme.
Hvordan slår jeg en hel ejendom op?
Med BFE-nummeret (Det Bestemte Faste Ejendoms-nummer) som indgang: ét kald på GET /v1/bbr/ejendom/:bfe returnerer alle bygninger og enheder joinet sammen, så du slipper for selv at håndtere connections, cursors og FK-strenge fra GraphQL-backenden.
Hvad koster BBR-opslag?
BBR kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som Matriklen, DAGI og adresser. Se priser for kald-inkluderet og overforbrug.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Data kommer fra Datafordeler; vi krediterer kilden.
BBR for hele Danmark
Bygnings- og Boligregistret for hver ejendom i landet — oversatte koder, gensammensatte navne og WGS84-geometri, serveret fra den cachede SLA-mirror. Kortet er farvet efter hvor mange adresser vi holder i hver kommune.
- Adresser
- 2.700.904
- Jordstykker
- 2.565.631
- Kommuner
- 98