# Adresseændringer i et område

`GET /v1/overvaagning/adresser/haendelser` · Overvågning

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

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 dashboard-session · kræver Pro-planen

**Afregning:** Ikke målt.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `kommunekode` | query | string | nej | Op til 10 kommunekoder, kommaseparerede. Tre cifre udfyldes med 0 foran. |
| `postnr` | query | string | nej | Op til 50 postnumre, kommaseparerede. |
| `adgangsadresse_id` | query | string | nej | Op til 100 adgangsadresse-id’er (UUID), kommaseparerede. |
| `haendelse` | query | string | nej | Kun én slags ændring. |
| `efter` | query | integer | nej | Returnér kun ændringer med `sekvens` større end dette tal. |
| `antal` | query | integer | nej | Ændringer pr. side, 1-100. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/overvaagning/adresser/haendelser?kommunekode=0101&postnr=2200" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "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,
      "huller": []
    }
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `haendelser[].sekvens` | integer | Globalt, stigende løbenummer. Brug det som markør og til at fjerne dubletter. |
| `haendelser[].aendrede_felter` | string[] | Kun for `adresse.aendret`: hvilke af `betegnelse`, `vejnavn`, `husnr`, `postnr`, `postnrnavn`, `kommunekode` og `koordinat` der ændrede sig. |
| `haendelser[].foer` | object \| null | Adressen før ændringen; `null` for `adresse.oprettet`. |
| `haendelser[].efter` | object \| null | Adressen efter ændringen; `null` for `adresse.nedlagt`. |
| `naeste_efter` | integer | Send som `efter` i næste kald, så du hverken springer over eller gentager. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Intet område angivet, en ugyldig kommunekode, et ugyldigt postnummer eller id, eller for mange værdier. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 402 | Planen er under Pro. |
| 403 | Nøglen er en admin-nøgle, eller kontoen er suspenderet. |
| 429 | Burst-grænsen pr. minut er nået. |