Din første forespørgsel
Fra en adresse til hele ejendommen: opret en gratis konto, hent en API-nøgle og lav to kald. Det tager under to minutter.
På denne side· 5 afsnit
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.
curl https://api.grundfast.dk/v1/demo/ejendomTilsvarende 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 API-nøgle
Opret en gratis konto i dashboardet og lav en API-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. Gem den som miljøvariablenGRUNDFAST_API_KEY, så den aldrig står i koden — alle eksempler her læser den derfra.bashexport GRUNDFAST_API_KEY="<din gf_test_-nøgle>"Find ejendommen ud fra adressen
Kald
GET /v1/adresse/search?q=…med adressen som tekst. Det første resultat har ejendommens BFE-nummer (bfe_nummer— ejendommens nummer i de offentlige registre) og adressens koordinat.Hent hele ejendommen i ét kald
Kald
GET /v1/ejendom/:bfemed BFE-nummeret. Svaret samler bygninger (BBR), grund og matrikel, vurdering, terræn, lokalplan, byggelinjer og meget mere.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.
Kaldene
# 1) Adresse → BFE-nummer
curl -G https://api.grundfast.dk/v1/adresse/search \
--data-urlencode "q=Solbakkevej 70, 8600 Silkeborg" \
--data-urlencode "per_side=1" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"
# 2) BFE-nummer → hele ejendommen
curl https://api.grundfast.dk/v1/ejendom/5651067 \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"Uden en gyldig API-nøgle svarer API’et 401. Alle fejl har samme form — byg logikken på type, og vis message til brugeren:
{
"error": "invalid API key",
"type": "invalid_api_key",
"code": "api_key_missing",
"message": "API-nøglen mangler, er ugyldig eller udløbet.",
"request_id": "b4dba773-9a87-4827-8795-54c548929fb1",
"doc_url": "https://grundfast.dk/docs/fejl#invalid_api_key"
}Authorization: Bearer …. Kun hvor en header ikke kan sættes, kan den sendes som ?token= (se Godkendelse). Alle fejltyper står i Fejl og statuskoder.Svaret
Sådan ser svaret fra /v1/ejendom/5651067 ud — et parcelhus på Solbakkevej 70 i Silkeborg. Svaret er langt; her er et udpluk af de vigtigste blokke.
{
"bfe_nummer": 5651067,
"adresse": { "betegnelse": "Solbakkevej 70, 8600 Silkeborg" },
"bbr": {
"antal_bygninger": 2,
"antal_enheder": 1,
"samlet_boligareal_m2": 95,
"hovedbygning_opfoerelsesaar": 1958,
"hovedbygning_anvendelse": "Fritliggende enfamiliehus"
},
"parcel": {
"matrikelnummer": "138o",
"ejerlavsnavn": "Silkeborg Markjorder",
"areal_m2": 460
},
"vurdering": {
"seneste": { "aar": 2024, "ejendomsvaerdi_kr": 2596000, "grundvaerdi_kr": 1702000 }
},
"terraen": { "terraen_m": 27.94, "overflade_m": 27.94 },
"plan": {
"zone": { "status": "byzone" },
"har_lokalplan": false
},
"meta": { "kilde": "Grundfast", "id": "5651067", "id_type": "bfe" }
}
BFE-nummeret er ejendommens nøgle i alle registre.
:idkan også være et adresse-id fra DAR (en UUID) — men ikke adresseteksten; den slår du op med/v1/adresse/search.Hovedbygningens anvendelse og opførelsesår, antal bygninger og boligareal. Alle bygninger med materialer, varme og etager står på
/v1/bbr/ejendom/:bfe.Matrikelnummer (grundens nummer i Matriklen), ejerlav og areal i m².
Seneste offentlige vurdering og terrænkoten i meter over havet (DVR90), målt i
opslagspunktinde på grunden — se terrænkoten for en adresse.Zone, lokalplaner og kommuneplanramme.
nullbetyder, at registret ikke kunne svare — aldrig "ingen".
Alle felter står på referencesiden for ejendomsprofilen. Hvordan null, kodefelter og koordinater skal læses, står i Svar, null og friskhed.