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, materialer: { ydervaeg: { tekst: "Mursten" }, tag: { tekst: "Tegl" } }, 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[].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å BBR-historik med ?asOf=, Matrikel-API’et, Adresse-API’et (DAR), Datafordeler-alternativ og DAWA-alternativ, eller se hvordan du migrerer fra services.datafordeler.dk.
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