Nedlagte adresser og adressehistorik

Adresser forsvinder. En bygning rives ned, to lejligheder lægges sammen, en ejendom får nyt husnummer. Har du gemt adressen på en kunde, en sag eller en måler, skal du kunne opdage, at den ikke længere findes, og helst hvornår det skete.

Adresseregistret beholder nedlagte adresser med en status, og API'et lader dig slå dem op.

Status-feltet#

Hver adresse og adgangsadresse har et status-felt:

Brug status til at afgøre, om adressen er aktiv. Svarene har også feltet darstatus med DAR's egne koder: 3 gældende, 2 foreløbig, 4 nedlagt og 5 henlagt (status 1, 3, 2 og 4). Byg din logik på det ene af dem, ikke en blanding. Se også status, darstatus og nedlagte adresser.

Slå en gemt adresse op#

GET /adresser/{id} og GET /adgangsadresser/{id} returnerer adressen uanset status. En nedlagt adresse svarer altså 200 med "status": 2:

curl -s "https://api.danadresse.dk/adresser/0a3f50c3-d930-32b8-e044-0003ba298018" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

Får du 404 med koden not_found, kender registret slet ikke id'et. Det sker typisk, når id'et kommer fra en anden kilde eller er tastet forkert.

Lister og søgninger viser gældende og foreløbige adresser#

/adresser og /adgangsadresser returnerer som standard adresser med status 1 og 3, ligesom DAWA. Det gælder også filtrene id, postnr, cirkel, polygon osv. Tilføj flaget medtagnedlagte (uden værdi), hvis nedlagte og henlagte adresser skal med, eller vælg en bestemt status med status=2. Begge virker også sammen med cirkel og polygon:

import os
import requests

ids = "0a3f50c3-d930-32b8-e044-0003ba298018|fec4202d-1015-425d-a3f5-5d21d03194b6"
s = requests.Session()
s.headers["X-Api-Key"] = os.environ["DANADRESSE_API_KEY"]

for medtag in (False, True):
    params = {"id": ids, "struktur": "mini"}
    if medtag:
        params["medtagnedlagte"] = ""   # bart flag: ?medtagnedlagte
    r = s.get("https://api.danadresse.dk/adresser", params=params, timeout=10)
    r.raise_for_status()
    print("medtagnedlagte" if medtag else "standard", "->", len(r.json()), "adresser")
    for a in r.json():
        print(f'  status={a["status"]} {a["betegnelse"]}')

Autocomplete og datavask finder kun adresser, der er i brug. De kan ikke bruges til at genfinde en nedlagt adresse, men datavask kan finde den adresse, der afløste den (se nedenfor).

Hvornår blev adressen nedlagt?#

Adressen har en historik-blok:

{
  "id": "0a3f50c3-d930-32b8-e044-0003ba298018",
  "status": 2,
  "darstatus": 4,
  "historik": {
    "oprettet": "2000-02-05T15:27:12.000",
    "ændret": "2026-10-05T10:20:23.000",
    "ikrafttrædelse": "2000-02-05T15:27:12.000",
    "nedlagt": "2026-10-05T10:20:23.000"
  }
}

For en adresse med status 2 eller 4 står tidspunktet for nedlæggelsen i nedlagt. For gældende adresser er nedlagt null. Tidspunkterne er dansk tid uden zone, som i DAWA.

Adressens versioner#

GET /historik/adresser?id=… og GET /historik/adgangsadresser?id=… virker som i DAWA. Svaret er en liste med én række pr. version: status, vejnavn, husnummer, postnummer, etage og dør (for adresser) samt virkningstart og virkningslut i UTC. Ældste version først. id tager op til 100 id'er adskilt af |:

curl -s "https://api.danadresse.dk/historik/adresser?id=0a3f50c3-d930-32b8-e044-0003ba298018|fec4202d-1015-425d-a3f5-5d21d03194b6" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

Historikken dækker ændringer fra juli 2026, hvor vores ændringslog startede. Ældre versioner har vi ikke, og en adresse, der ikke er ændret siden, har én version.

Følg ændringerne fremover#

Vil du opdage ændringer, mens de sker:

1. Gem det, du ser. Gem adressens felter og status sammen med en dato, når du bruger den. Så har du din egen historik for de adresser, der betyder noget for dig.
2. Følg ændringerne. Hent hændelser med GET /replikering/haendelser?entitet=adresse&sekvensnummerfra=N (og tilsvarende med entitet=adgangsadresse). Hver hændelse har operation (insert, update eller delete), tidspunkt og de nye data. Gem hændelserne for de id'er, du holder øje med. Se Hent ændringer med hændelser.
3. Få besked med det samme. En webhook giver dig id'erne på ændrede adresser, kort efter de er ændret. Se Webhooks: opsætning.

# Seneste sekvensnummer, så du ved, hvor du starter (kræver ingen nøgle)
curl -s "https://api.danadresse.dk/replikering/senestesekvensnummer"

# Hændelser for adresser fra et gemt sekvensnummer, ældste først
curl -s "https://api.danadresse.dk/replikering/haendelser?entitet=adresse&sekvensnummerfra=207900000&maxantal=100" \
  -H "X-Api-Key: $DANADRESSE_API_KEY"

Hændelsesloggen starter ved skiftet til Datafordeleren i oktober 2026 (sekvensnummer omkring 207 900 000). Ældre hændelser kan ikke hentes.

Hvad gør du med en nedlagt adresse?#

• Kunder og leveringsadresser: Send ikke pakker til en adresse med status 2 eller 4. Vask den gemte tekst med datavask: giver den A eller B, er aktueladresse i resultatet afløseren. Giver den C, så bed kunden om en ny adresse næste gang, de logger ind eller bestiller. Se Gem adresse-id'et.
• Sager og målere: Find den nye adresse på samme sted. Slå de gældende adresser op i nærheden med GET /adgangsadresser?cirkel=lon,lat,25 ud fra den nedlagte adresses koordinater (de står stadig i svaret). Tilføj medtagnedlagte, hvis du også vil se de andre nedlagte adresser på stedet.
• Statistik: Behold den nedlagte adresse og dens id. Historiske tal skal pege på den adresse, der gjaldt dengang.

Registret har ingen direkte henvisning fra en nedlagt adresse til den, der afløste den. Datavask af teksten eller et opslag i nærheden er vejen.

Næste skridt#

• Gem adresse-id'et og valider igen senere
• status, darstatus og nedlagte adresser
• Hent ændringer med hændelser