Spring til indhold

Grundfast

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 gratisSe 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 · Vurderingsstyrelsen5 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. 1Brugeren 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 svaretjson
    {
  "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. 2Huset bag adressen

    GET /v1/bbr/ejendom/6033800

    Bygninger og enheder med oversatte koder — anvendelse, år, etager, arealer, materialer og varme.

    uddrag · /v1/demo/propertyjson
    {
  "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. 3Og 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/propertyjson
    {
  "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[].betegnelseadgangsadresse_idbfe_nummer
Adresser (DAR)
Importen er fuld af stavefejl — hvad er den rigtige?
kategoriresultater[].lighedresultater[].betegnelse
Datavask
Hvad er det for et hus?
anvendelse.tekstopfoerelsesaarantal_etagervarme.installation
BBR
Hvor stor er boligen?
enheder[].areal.samlet_m2enheder[].antal_vaerelserareal.samlet_boligareal_m2
BBR
Hvad er den offentligt vurderet til?
seneste.ejendomsvaerdi_krseneste.grundvaerdi_krseneste.aar
Ejendomsvurdering
Hvilket energimærke har den?
label.klasselabel.gyldig_til503 = endnu ikke dækket
Energimærke

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/searchType-ahead over alle danske adresser — hvert forslag bærer BFE-nummeret.
  2. GET/v1/datavask/adgangsadresserFrie adressestrenge til DAR-adresse med en A/B/C-sikkerhed.
  3. GET/v1/bbr/ejendom/:bfeBygninger og enheder med oversatte koder og vurderingsresumé.
  4. GET/v1/vurdering/:bfeEjendoms- og grundværdi, hele serien.
  5. GET/v1/energimaerke/:bfeEnergimærket, hvor vi har det: 503 betyder endnu ikke dækket, aldrig “intet mærke”.
  6. POST/v1/me/webhooksProSignerede hændelser: ændringer på overvågede ejendomme (Pro), nøgler, abonnement og forbrugstærskler.
# 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
AI-agent med Grundfast MCPPOST /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.

Spørgsmål

Ofte stillede spørgsmål

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.

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.

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.

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.

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 gratisSe SDK’et

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0