Spring til indhold

Grundfast

Adresseændringer i et område

Nye, ændrede og nedlagte adgangsadresser fra den daglige DAR-opdatering, i en kommune, et postnummer eller for konkrete id’er.

GET/v1/overvaagning/adresser/haendelser

Feedet er det samme, som adresse.*-webhooks leveres fra. Ændringerne kommer i stigende sekvens-orden og gemmes i 35 dage. Angiv mindst én af kommunekode, postnr og adgangsadresse_id; en ændring kommer med, når den matcher én af dem.

Gem naeste_efter, og send den som efter i næste kald. Er flere true, ligger der allerede flere ændringer klar. En ændring hører til området, adressen ligger i efter ændringen; en nedlagt adresse hører til der, hvor den lå.

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 "https://api.grundfast.dk/v1/overvaagning/adresser/haendelser?kommunekode=0101&postnr=2200" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "antal": 2,
  "haendelser": [
    {
      "sekvens": 48210,
      "haendelse": "adresse.oprettet",
      "adgangsadresse_id": "b1d2e3f4-0a1b-4c2d-9e3f-4a5b6c7d8e9f",
      "betegnelse": "Kalvebod Brygge 59, 1560 København V",
      "kommunekode": "0101",
      "postnr": "1560",
      "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 }
      },
      "dar_udtraek": "DAR_20261001040010",
      "registreret": "2026-10-01T05:10:02.551Z"
    },
    {
      "sekvens": 48211,
      "haendelse": "adresse.aendret",
      "adgangsadresse_id": "0a3f507a-b2e6-32b8-e044-0003ba298018",
      "betegnelse": "Rådhuspladsen 1, 1550 København V",
      "kommunekode": "0101",
      "postnr": "1550",
      "status": "gaeldende",
      "aendrede_felter": ["koordinat"],
      "foer": {
        "betegnelse": "Rådhuspladsen 1, 1550 København V",
        "vejnavn": "Rådhuspladsen",
        "husnr": "1",
        "postnr": "1550",
        "postnrnavn": "København V",
        "kommunekode": "0101",
        "koordinat": { "lon": 12.56953, "lat": 55.67568 }
      },
      "efter": {
        "betegnelse": "Rådhuspladsen 1, 1550 København V",
        "vejnavn": "Rådhuspladsen",
        "husnr": "1",
        "postnr": "1550",
        "postnrnavn": "København V",
        "kommunekode": "0101",
        "koordinat": { "lon": 12.56961, "lat": 55.67571 }
      },
      "dar_udtraek": "DAR_20261001040010",
      "registreret": "2026-10-01T05:10:02.551Z"
    }
  ],
  "naeste_efter": 48211,
  "flere": false,
  "meta": {
    "kilde": "Danmarks Adresseregister (DAR) — dagligt ændringsudtræk, via Grundfast",
    "grundfast_version": "1.0.0",
    "feed": {
      "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
    }
  }
}

Parametre

kommunekodestringqueryvalgfri
Op til 10 kommunekoder, kommaseparerede. Tre cifre udfyldes med 0 foran.Eksempel: 0101
postnrstringqueryvalgfri
Op til 50 postnumre, kommaseparerede.Eksempel: 2200
adgangsadresse_idstringqueryvalgfri
Op til 100 adgangsadresse-id’er (UUID), kommaseparerede.
haendelsestringqueryvalgfri
Kun én slags ændring.Værdier:adresse.oprettetadresse.aendretadresse.nedlagt
efterintegerqueryvalgfri
Returnér kun ændringer med sekvens større end dette tal.Standard:0
antalintegerqueryvalgfri
Ændringer pr. side, 1-100.Standard:100

Felter i svaret

haendelser[].sekvensinteger
Globalt, stigende løbenummer. Brug det som markør og til at fjerne dubletter.
haendelser[].aendrede_felterstring[]
Kun for adresse.aendret: hvilke af betegnelse, vejnavn, husnr, postnr, postnrnavn, kommunekode og koordinat der ændrede sig.
haendelser[].foerobject | null
Adressen før ændringen; null for adresse.oprettet.
haendelser[].efterobject | null
Adressen efter ændringen; null for adresse.nedlagt.
naeste_efterinteger
Send som efter i næste kald, så du hverken springer over eller gentager.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Intet område angivet, en ugyldig kommunekode, et ugyldigt postnummer eller id, eller for mange værdier.
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.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

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/overvaagning/adresser/haendelser?kommunekode=0101&postnr=2200

Bruges ofte sammen med