Din første forespørgsel

Opret en gratis konto, hent en nøgle og slå en ejendom op. Det tager under to minutter.

Prøv uden nøgle

Demo-endpoints under /v1/demo/* svarer uden nøgle for et fast emne — rigtige data, fx ejendommen BFE 5651067 — i samme form som de rigtige endpoints. De er begrænset pr. IP-adresse og egner sig til at se svarformen, ikke til produktion.

terminalbash

curl https://api.grundfast.dk/v1/demo/ejendom

Tilsvarende findes blandt andet /v1/demo/matrikel, /v1/demo/adresse, /v1/demo/dhm, /v1/demo/byggelinjer, /v1/demo/vurdering og /v1/demo/cvr.

Fire trin

Opret en konto og en testnøgle
Opret en gratis konto i dashboardet og lav en nøgle under Nøgler. Vælg en gf_test_-nøgle til udvikling: den rammer de rigtige registre, men faktureres aldrig. Nøglen vises kun én gang, så gem den med det samme.
Hent en ejendom
Kald GET /v1/bbr/ejendom/:bfe med nøglen i Authorization-headeren. Eksemplerne herunder bruger BFE 5651067.
Læs svaret
Svaret er én ejendom med alle bygninger, jordstykker og adresser. Et forkortet svar og de vigtigste felter står nedenfor.
Byg videre
Læs om fejl og statuskoder og rate limits, før du går i produktion, og skift til en gf_live_-nøgle.

Kaldet

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

Uden en gyldig nøgle svarer API’et 401 med { "error": "invalid API key" }. Send nøglen i headeren; kun hvor en header ikke kan sættes, kan den sendes som ?token= (se Godkendelse).

Svaret

Sådan ser svaret for BFE 5651067 ud — et parcelhus i Silkeborg. Ejendommen har tre bygninger; her vises kun hovedbygningen, bygninger[2], som hovedbygning_index peger på.

Svar · 200 · forkortetPeg på en note, så lyser felterne op

{
  "type": "ejendom",
1  "bfe_nummer": 5651067,
1  "kommunekode": "0740",
2  "jordstykke": {
    "matrikelnummer": "138o",
    "ejerlav_kode": 2006552,
    "ejerlav_navn": "Silkeborg Markjorder"
  },
3  "antal_bygninger": 3,
3  "hovedbygning_index": 2,
  "bygninger": [
    {
      "bygningsnummer": 1,
4      "anvendelse": { "kode": "120", "tekst": "Fritliggende enfamiliehus" },
5      "opfoerelsesaar": 1958,
5      "areal": { "bebygget_m2": 116, "samlet_boligareal_m2": 95 },
4      "materialer": {
        "ydervaeg": { "kode": "1", "tekst": "Mursten" },
        "tag": { "kode": "5", "tekst": "Tegl" }
      },
4      "varme": { "installation": { "kode": "1", "tekst": "Fjernvarme/blokvarme" } },
6      "geometri": {
        "type": "Point",
6        "coordinates": [9.532961, 56.1578452],
6        "epsg25832": [533103.83, 6223775.44]
      }
    }
  ],
  "meta": { "kilde": "Datafordeler BBR via Grundfast", "grundfast_version": "0.1.0" }
}

Ejendommens BFE-nummer, og kommunekoden som firecifret streng — "0740" er Silkeborg.
Matrikelnummer og ejerlav. Alle jordstykker på ejendommen står i jordstykker[].
hovedbygning_index er indekset i bygninger for den største bygning. Læs årstal og areal herfra — bygninger[0] kan være en tom registrering.
Hvert kodefelt er { kode, tekst }: gem koden, vis teksten. null betyder, at registret ikke har en værdi.
om_tilbygningsaar er året for seneste væsentlige om- eller tilbygning, og arealerne er i m². Ikke vist her: fredning, hvor null betyder ukendt, og boligerne i enheder[].
WGS84 i coordinates og EPSG:25832 i epsg25832 — se Koordinatsystemer.

Et fuldt eksempelsvar og alle felter står på referencesiden for endpointet. Hvordan null, kodefelter og koordinater skal læses, står i Svar, null og friskhed.

Næste skridt

Godkendelse og nøglerForskellen på live og test, og hvordan du tilbagekalder en nøgle.API-referenceAlle endpoints: matrikel, vurdering, adresser, DHM, byggelinjer og resten.TypeScript-SDKTypede svar, indbygget retry og afbrydelse med AbortSignal.MCP-serverLad en AI-agent slå ejendomme op med den samme nøgle.