Bolig-, forsikrings- og mæglerplatforme # Fra adressefelt til boligkort i to kald Fang adressen rigtigt, mens brugeren taster, og vis huset bag den: bygninger, enheder, arealer, varme og den offentlige vurdering — med stabile feltnavne, oversatte koder og et typet SDK. [Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) Se kaldene Bygget til Boligapps · Forsikring · Mæglersystemer · Energirenovering DAR Prøv din egen adresse — forslag og boligkort hentes live fra demo-API’et. Nyhavn 20, 1051 København K Bygning til kontor BFE 6033800 **Opført** 1845 · om 1967 **Etager** 3 **Enheder** 12 **Boligareal** 480 m² **Erhvervsareal** 1.958 m² **Grund** 759 m² **Varme** Fjernvarme/blokvarme **Ejendomsværdi 2020** 50.000.000 kr. BBR · Matriklen · Vurderingsstyrelsen 5 adgangsadresser på BFE’et Eksempel på en rigtig ejendom ## Fra tastetryk til boligkort De tre svar bag kortet ovenfor, for en ejendom i Nyhavn med både boliger og erhverv. Uddragene er skåret af det samme svar, som kortet er tegnet af. 1. 1 Brugeren taster `GET /v1/adresse/search?q=nyhavn+20` Rangerede forslag fra DAR, mens der tastes. Hvert forslag bærer BFE-nummeret, så valget er entydigt. uddrag af svaret json ``` { "results": [ { "betegnelse": "Nyhavn 20, 1051 København K", "adgangsadresse_id": "0a3f507a-cdbb-32b8-e044-0003ba298018", "bfe_nummer": 6033800, "koordinat": { "lon": 12.590497, "lat": 55.679527 } } ] } ``` 2. 2 Huset bag adressen `GET /v1/bbr/ejendom/6033800` Bygninger og enheder med oversatte koder — anvendelse, år, etager, arealer, materialer og varme. uddrag · /v1/demo/property json ``` { "bbr": { "antal_bygninger": 3, "antal_enheder": 12, "samlet_boligareal_m2": 480, "samlet_erhvervsareal_m2": 1958, "hovedbygning_opfoerelsesaar": 1845, "hovedbygning_om_tilbygningsaar": 1967, "hovedbygning_anvendelse": "Bygning til kontor" } } ``` 3. 3 Og hvad den er vurderet til `GET /v1/vurdering/6033800` Den offentlige ejendoms- og grundværdi, med hele serien bag. Et BFE med flere vurderingsejendomme siger det selv. uddrag · /v1/demo/property json ``` { "vurdering": { "antal_vurderingsejendomme": 1, "seneste": { "aar": 2020, "ejendomsvaerdi_kr": 50000000, "grundvaerdi_kr": 11650700, "vurderet_areal_m2": 759 } } } ``` Felt for felt ## Hvilket felt svarer på hvilket spørgsmål Det, en boligplatform viser, oversat til felterne i svaret — inklusive den tilstand, I skal designe for, når et energimærke endnu ikke er dækket. **Brugeren taster en adresse — hvilken er det?** `results[].betegnelse` `adgangsadresse_id` `bfe_nummer` [Adresser (DAR)](https://grundfast.dk/adresse-api) **Importen er fuld af stavefejl — hvad er den rigtige?** `kategori` `resultater[].lighed` `resultater[].betegnelse` [Datavask](https://grundfast.dk/datavask-api) **Hvad er det for et hus?** `anvendelse.tekst` `opfoerelsesaar` `antal_etager` `varme.installation` [BBR](https://grundfast.dk/bbr-api) **Hvor stor er boligen?** `enheder[].areal.samlet_m2` `enheder[].antal_vaerelser` `areal.samlet_boligareal_m2` [BBR](https://grundfast.dk/bbr-api) **Hvad er den offentligt vurderet til?** `seneste.ejendomsvaerdi_kr` `seneste.grundvaerdi_kr` `seneste.aar` [Ejendomsvurdering](https://grundfast.dk/ejendomsvurdering-api) **Hvilket energimærke har den?** `label.klasse` `label.gyldig_til` `503 = endnu ikke dækket` [Energimærke](https://grundfast.dk/docs/api) Kaldene ## Søgning og opslag med én nøgle Søgning, datavask og opslag med samme nøgle, samme fejlformat og samme svarform. SDK’et er typet til hvert felt, og API’et er versioneret under /v1, så jeres kode ikke skal følge med, hver gang et register skifter form. 1. [GET `/v1/adresse/search` Type-ahead over alle danske adresser — hvert forslag bærer BFE-nummeret.](https://grundfast.dk/adresse-autocomplete-api) 2. [GET `/v1/datavask/adgangsadresser` Frie adressestrenge til DAR-adresse med en A/B/C-sikkerhed.](https://grundfast.dk/datavask-api) 3. [GET `/v1/bbr/ejendom/:bfe` Bygninger og enheder med oversatte koder og vurderingsresumé.](https://grundfast.dk/bbr-api) 4. [GET `/v1/vurdering/:bfe` Ejendoms- og grundværdi, hele serien.](https://grundfast.dk/ejendomsvurdering-api) 5. [GET `/v1/energimaerke/:bfe` Energimærket, hvor vi har det: 503 betyder endnu ikke dækket, aldrig “intet mærke”.](https://grundfast.dk/docs/api) 6. [POST `/v1/me/webhooks` Pro Signerede hændelser: ændringer på overvågede ejendomme (Pro), nøgler, abonnement og forbrugstærskler.](https://grundfast.dk/docs/webhooks) ``` # Mens brugeren taster — hvert forslag bærer BFE-nummeret curl -H "Authorization: Bearer gf_live_xxx" \ "https://api.grundfast.dk/v1/adresse/search?q=nyhavn+20&per_side=5" # Når brugeren vælger — hele ejendommen bag BFE-nummeret curl -H "Authorization: Bearer gf_live_xxx" \ "https://api.grundfast.dk/v1/bbr/ejendom/6033800" ``` Spørg din AI-agent ## Samme data, stillet som et spørgsmål Forbind Claude, Cursor eller en anden MCP-klient til Grundfast med jeres nøgle, og spørg på dansk. Agenten vælger selv værktøjerne — de samme endpoints som ovenfor — og svarer med kilden på. [Forbind jeres AI-agent](https://grundfast.dk/mcp-server) AI-agent med Grundfast MCP `POST /mcp` Hvad kan vi vise brugeren om Nyhavn 20, 1051 København K? 1. adresse_soeg(q: "Nyhavn 20, 1051 København K") → BFE 6033800 · 5 adgangsadresser 2. bbr_ejendom(bfe: 6033800) → 3 bygninger · 12 enheder 3. ejendomsvurdering(bfe: 6033800) → 2020: 50.000.000 kr. - Ejendommen har 3 bygninger og 12 enheder — 480 m² bolig og 1.958 m² erhverv. - Hovedbygningen er opført 1845 og om-/tilbygget 1967. - Den offentlige ejendomsværdi er 50.000.000 kr. (2020), heraf grundværdi 11.650.700 kr. - 5 adgangsadresser hører til samme BFE — vis dem, så brugeren genkender sin egen. Kilder: DAR · BBR · Vurderingsstyrelsen Et eksempel på en samtale med en AI-agent, der bruger Grundfasts MCP-server. Værktøjskaldene og tallene er bygget af de samme API-svar som eksemplet ovenfor. I produktion ## Det, jeres tech lead spørger om Oppetid, datakilder, persondata og hvad der sker, når en kilde er nede. - [Officielle kilder BBR, Matriklen, DAR, Vurderingsstyrelsen, DHM, CVR og Danmarks Miljøportal — åbne data, de fleste under CC BY 4.0, og hvert svar siger, hvor det kommer fra. Om Grundfast](https://grundfast.dk/om) - [Drift, målt og offentlig Svarene kommer fra en cachet mirror af registrene, så en upstream-fejl ikke bliver jeres. Status for API’et og hver kilde er live. Se status](https://grundfast.dk/status) - [Oppetidsmål og SLA Alle planer har et oppetidsmål på 99,9 %. Enterprise får en kontraktuel SLA, årlig faktura og en fast kontakt. Se planerne](https://grundfast.dk/priser) - [Databehandleraftale Hosting og underdatabehandlere i EU/EØS. Ejernavne udleveres ikke. DPA til erhvervskunder. Læs aftalen](https://grundfast.dk/databehandleraftale) Spørgsmål ## Ofte stillede spørgsmål ### Har I energimærker for alle boliger? Nej, og det siger svaret ærligt. Energimærker hentes ejendom for ejendom, så `/v1/energimaerke/:bfe` svarer kun for de ejendomme, vi har dækket. Mangler en ejendom, svarer endpointet 503 “endnu ikke dækket” — aldrig 404, fordi en 404 ville påstå, at huset ikke har et mærke. Byg jeres UI til den tredje tilstand. ### Kan vi få besked, når BBR ændrer sig for en bolig? Ja, fra Pro. Sæt boligerne på en overvågningsliste med `/v1/overvaagning/ejendomme`, så sender vi en signeret webhook, når BBR, vurdering, plandata eller jordforurening ændrer sig for dem — hver ejendom tjekkes cirka én gang i døgnet. Listen rummer 250 ejendomme på Pro og 2.500 på Scale. Med historik (Scale) kan I desuden se, hvad der er ændret og hvornår. ### Hvad sker der, når Datafordeler er nede? Jeres opslag svarer fra vores cachede mirror af registrene, så en upstream-fejl ikke bliver jeres fejl. Driftsstatus for vores API og for hver kilde er live på statussiden. Alle planer har et oppetidsmål på 99,9 %, og Enterprise får en kontraktuel SLA. ### Er der et SDK, og ændrer svarene sig under os? Det typede TypeScript-SDK ligger på npm som @grundfast/sdk og dækker alle læse-endpoints. API’et er versioneret under /v1, ændringer står i changeloggen, og svarformen er dokumenteret i OpenAPI på /docs/api. ### Hvordan håndterer I persondata? BBR, vurdering og adresser er offentlige registerdata. Ejernavne udleveres ikke. Vi indgår databehandleraftale med erhvervskunder, og alle underdatabehandlere ligger i EU/EØS. Andre løsninger ## Samme nøgle, andre opgaver Kom i gang ## Byg boligkortet i jeres app Opret en gratis konto, brug testnøglen under udvikling, og installér SDK’et med npm install @grundfast/sdk. [Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Se SDK’et](https://grundfast.dk/docs/sdk) Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0