Spring til indhold

Grundfast

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.

terminal
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.

Ikke udvikler?

Vil du bare slå en adresse op — fx terrænkoten, byggeretten eller BBR-oplysningerne — så brug Værktøjer. De kalder de samme registre og kræver ingen kode. Se også Uden kode.

Fire trin

  1. 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øvariablen GRUNDFAST_API_KEY, så den aldrig står i koden — alle eksempler her læser den derfra.

    bash
    export GRUNDFAST_API_KEY="<din gf_test_-nøgle>"
  2. 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.

  3. Hent hele ejendommen i ét kald

    Kald GET /v1/ejendom/:bfe med BFE-nummeret. Svaret samler bygninger (BBR), grund og matrikel, vurdering, terræn, lokalplan, byggelinjer og meget mere.

  4. 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:

Svar · 401
{
  "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"
}
Send nøglen i headeren 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.

Svar · 200 · udpluk
{
  "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" }
}
  1. BFE-nummeret er ejendommens nøgle i alle registre. :id kan også være et adresse-id fra DAR (en UUID) — men ikke adresseteksten; den slår du op med /v1/adresse/search.

  2. Hovedbygningens anvendelse og opførelsesår, antal bygninger og boligareal. Alle bygninger med materialer, varme og etager står på /v1/bbr/ejendom/:bfe.

  3. Matrikelnummer (grundens nummer i Matriklen), ejerlav og areal i m².

  4. Seneste offentlige vurdering og terrænkoten i meter over havet (DVR90), målt i opslagspunkt inde på grunden — se terrænkoten for en adresse.

  5. Zone, lokalplaner og kommuneplanramme. null betyder, 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.

Næste skridt