Spring til indhold

Grundfast

Ændringsfeed for adresser og bygninger

Nye, ændrede og nedlagte adresser og bygninger i en kommune eller et postnummer — ét feed, sidet med en cursor.

GET/v1/aendringer

Feedet fletter to logs efter registreringstidspunkt, ældste først. Adresser kommer fra DARs daglige ændringsudtræk: typisk et døgn bagud, og de gemmes i 35 dage. Bygninger findes ved at sammenligne to udgaver af vores nationale bygningsindeks, som bygges ud fra BBR’s samlede udtræk. Indekset bygges automatisk igen, så snart Datafordeler har udgivet et nyt samlet BBR-udtræk (vi spørger hver tredje time). Udtrækkene udkommer med nogle dages forsinkelse, så en bygningsændring er typisk få dage bagud — meta.daekning.bygning.seneste_snapshot siger præcis, hvor gammel den nyeste udgave er — og kun de felter, indekset rummer (anvendelse, år, arealer, etager, varme, tag, ydervæg, asbest, olietank, adresse, BFE og koordinat), sammenlignes.

bygning.tilkommet betyder, at bygningen nu er registreret som opført, og bygning.udgaaet, at den ikke længere er det — revet ned, eller registreringen er rettet. Ingen af dem er en påstand om, hvad der er sket på stedet.

Angiv mindst én kommunekode eller ét postnr. Gem naeste_cursor, og send den som cursor i næste kald; så hverken springer du over eller gentager. Et tomt svar betyder kun "ingen ændringer" inden for det vindue, meta.daekning beskriver. Kunne et DARs udtræks ændringer ikke logges, står udtrækket i meta.daekning.adresse.huller, og forsinket er true — de adresseændringer er ikke i feedet.

Godkendelse · API-nøgle eller session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ikke målt.

Eksempel

curl -G "https://api.grundfast.dk/v1/aendringer" \
  --data-urlencode "kommunekode=0101" \
  --data-urlencode "postnr=2200" \
  --data-urlencode "siden=2026-10-01" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel, forkortet200
{
  "antal": 2,
  "aendringer": [
    {
      "type": "adresse",
      "id": "adresse:48210",
      "haendelse": "adresse.oprettet",
      "registreret": "2026-10-01T05:10:02.551Z",
      "kommunekode": "0101",
      "postnr": "1560",
      "adgangsadresse_id": "b1d2e3f4-0a1b-4c2d-9e3f-4a5b6c7d8e9f",
      "betegnelse": "Kalvebod Brygge 59, 1560 København V",
      "status": "gaeldende",
      "aendrede_felter": [],
      "foer": null,
      "efter": {
        "betegnelse": "Kalvebod Brygge 59, 1560 København V",
        "vejnavn": "Kalvebod Brygge",
        "husnr": "59",
        "postnr": "1560",
        "postnrnavn": "København V",
        "kommunekode": "0101",
        "koordinat": { "lon": 12.56712, "lat": 55.66431 }
      },
      "kilde": "DAR_20261001040010"
    },
    {
      "type": "bygning",
      "id": "bygning:913",
      "haendelse": "bygning.aendret",
      "registreret": "2026-10-03T18:20:11.004Z",
      "kommunekode": "0101",
      "postnr": "1560",
      "adgangsadresse_id": "b1d2e3f4-0a1b-4c2d-9e3f-4a5b6c7d8e9f",
      "betegnelse": "Kalvebod Brygge 59, 1560 København V",
      "bygning_id": "5f0c7a52-0d4e-4a34-9b6c-2f1d7e8a9b10",
      "bfe_nummer": 100154,
      "aendrede_felter": ["varmeinstallation"],
      "foer": { "id": "5f0c7a52-0d4e-4a34-9b6c-2f1d7e8a9b10", "varmeinstallation": { "kode": "2", "tekst": "Centralvarme med én fyringsenhed" } },
      "efter": { "id": "5f0c7a52-0d4e-4a34-9b6c-2f1d7e8a9b10", "varmeinstallation": { "kode": "1", "tekst": "Fjernvarme/blokvarme" } },
      "kilde": "2026-10-02T00:00:00.000Z"
    }
  ],
  "naeste_cursor": "eyJhIjo0ODIxMCwiYiI6OTEzfQ",
  "flere": false,
  "meta": {
    "kilde": "Danmarks Adresseregister (DAR, dagligt ændringsudtræk) og BBR (sammenligning af bygningsindeksets udgaver), via Grundfast",
    "grundfast_version": "1.0.0",
    "daekning": {
      "adresse": {
        "daekket_fra": "2026-09-01T05:10:04.118Z",
        "senest_opdateret": "2026-10-01T05:10:09.402Z",
        "seneste_udtraek": "DAR_20261001040010",
        "opbevaring_dage": 35,
        "forsinket": false,
        "huller": []
      },
      "bygning": {
        "daekket_fra": "2026-10-03T18:20:11.004Z",
        "seneste_snapshot": "2026-10-02T00:00:00.000Z",
        "opbevaring_dage": 120
      }
    }
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Parametre

kommunekodestringqueryvalgfri
Op til 10 kommunekoder, kommaseparerede. Tre cifre udfyldes med 0 foran.Eksempel: 0101
postnrstringqueryvalgfri
Op til 50 postnumre, kommaseparerede.Eksempel: 2200
typestringqueryvalgfri
adresse, bygning eller begge, kommaseparerede. Standard er begge.
sidenstringqueryvalgfri
Kun ændringer, Grundfast har registreret fra denne dato eller dette tidspunkt (ISO 8601).Eksempel: 2026-10-01
cursorstringqueryvalgfri
naeste_cursor fra forrige svar. Udelad for at starte fra den ældste.
antalintegerqueryvalgfri
Ændringer pr. side, 1-100.Standard:100

Felter i svaret

aendringer[].typestring
adresse eller bygning.
aendringer[].haendelsestring
adresse.oprettet / adresse.aendret / adresse.nedlagt, eller bygning.tilkommet / bygning.aendret / bygning.udgaaet.
aendringer[].aendrede_felterstring[]
Kun for *.aendret: hvilke felter der ændrede sig, med de samme navne som i foer/efter.
aendringer[].foer / efterobject | null
Adressen eller bygningen før og efter. En bygning har samme form som et hit i bygningssøgningen, med oversatte koder.
aendringer[].kildestring
DAR-udtrækket (DAR_<yyyymmddhhmmss>) eller BBR-snapshottet (ISO 8601), ændringen blev fundet i.
naeste_cursorstring
Send som cursor i næste kald.
meta.daekningobject
For adresser: daekket_fra, senest_opdateret, seneste_udtraek, forsinket og huller (DAR-udtræk, hvis ændringer ikke blev logget). For bygninger: daekket_fra og seneste_snapshot. Begge med opbevaring_dage.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Hverken kommunekode eller postnr angivet, en ugyldig værdi, for mange værdier, eller en cursor, API’et ikke har udstedt.
401Hverken en gyldig nøgle eller en session.
402Planen er under Pro.
403Nøglen er en admin-nøgle, eller kontoen er suspenderet.
429Burst-grænsen pr. minut er nået. Se Retry-After. Feedet måles ikke, så månedskvoten gælder ikke her.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/aendringer?kommunekode=0101&postnr=2200&siden=2026-10-01

Bruges ofte sammen med