---
title: "Address changes (created / changed / retired) in a kommune, postnummer or id list"
method: GET
path: "/v1/overvaagning/adresser/haendelser"
---

# Address changes (created / changed / retired) in a kommune, postnummer or id list

`GET /v1/overvaagning/adresser/haendelser`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/overvaagning/adresser/haendelser`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `gf_session`

The change feed behind the `adresse.*` webhooks: adgangsadresser the daily DAR delta created, changed or retired, in `sekvens` order. Give at least one of `kommunekode`, `postnr` or `adgangsadresse_id` (comma-separated lists allowed); page with `efter` = the previous response’s `naeste_efter`. Changes are kept for 35 days. An empty page means "no changes" only for the window `meta.feed` reports: from `daekket_fra` (the oldest change the feed holds — earlier changes were never logged or are past retention) up to `senest_opdateret` (the last successful daily DAR update), and only while `meta.feed.forsinket` is false — and never for a DAR delta listed in `meta.feed.huller` (applied to the index but not logged).

## Query parameters

- `kommunekode` string
- `postnr` string
- `adgangsadresse_id` string
- `haendelse` 'adresse.oprettet' | 'adresse.aendret' | 'adresse.nedlagt'
- `efter` integer
- `antal` integer

## Response `200`

One page of changes

- object
  - `antal` integer
  - `naeste_efter` integer
  - `flere` boolean
  - `meta` object
    - `kilde` string
    - `grundfast_version` string
    - `feed` object: What window this answer covers, and whether the daily DAR update is current.
      - `daekket_fra` string, date-time, nullable: Registration time of the oldest change the feed still holds; changes before it are not in the feed. null when it holds none yet.
      - `senest_opdateret` string, date-time, nullable: Last successful daily DAR update run (whether or not it found a new delta).
      - `seneste_udtraek` string, nullable: Newest DAR delta applied (`DAR_<yyyymmddhhmmss>`).
      - `opbevaring_dage` integer: Days a change stays readable.
      - `forsinket` boolean: True when the daily update has not succeeded for over 48 hours (or never), or when the newest applied DAR delta was not logged (see `huller`): the feed is behind, and an empty page says nothing about recent days.
      - `huller` object[]: DAR deltas (within retention) applied to the address index whose changes were NOT logged — not in this feed and never sent as webhooks. Empty when the log is whole.
        - `udtraek` string, required: The DAR delta (`DAR_<yyyymmddhhmmss>`).
        - `anvendt` string, date-time, required: When it was applied to the address index.
  - `haendelser` object[]
    - `sekvens` integer
    - `haendelse` string
    - `adgangsadresse_id` string
    - `betegnelse` string
    - `kommunekode` string, nullable
    - `postnr` string, nullable
    - `status` string, nullable
    - `aendrede_felter` string[]
    - `foer` object, nullable
    - `efter` object, nullable
    - `dar_udtraek` string
    - `registreret` string, date-time

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Error

---

[API](https://skmtc.dev/grundfast/apis/grundfast-api.md) · [All operations](https://skmtc.dev/grundfast/apis/grundfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grundfast/apis/grundfast-api/revisions/ccef6e299bb5?raw)