status, darstatus og nedlagte adresser

Adresser bliver oprettet, ændret og nedlagt. Når en ejendom rives ned, eller en vej omdøbes, er det id, du gemte for et år siden, måske ikke længere en gældende adresse. Felterne status og darstatus fortæller, hvor adressen er i sit livsforløb.

Guiden forklarer værdierne, hvilke endpoints der viser nedlagte adresser, og hvordan du tjekker dine gemte id'er.

Værdierne#

status er DAWA's felt. Det er det, du skal bygge din logik på:

darstatus er statuskoden fra Danmarks Adresseregister (DAR), som DAWA også sendte med:

For en gældende adresse er status 1 og darstatus 3. Det er det, du ser i langt de fleste svar. Brug status til beslutninger i din kode, og betragt darstatus som en ekstra oplysning.

Hvilke endpoints viser hvad#

To parametre styrer listerne:

• status=2 giver kun adresser med netop den status. Du kan bruge 1, 2, 3 eller 4.
• medtagnedlagte medtager adresser med alle statusværdier. Den kan skrives som et flag uden værdi, som i DAWA (?medtagnedlagte), eller som medtagnedlagte=true.

Det er DAWA's opførsel: uden parametre får du de adresser, der er i brug eller på vej (status 1 og 3), så et nybyggeri kan vælges, så snart det er registreret. Nedlagte og henlagte adresser (2 og 4) kommer kun med, når du beder om dem. Vil du kun have endelige adresser, så send status=1.

Feltet historik.nedlagt#

DAWA havde et historik-objekt med oprettet, ændret, ikrafttrædelse og nedlagt. Vi sender det samme objekt. historik.nedlagt indeholder tidspunktet, hvor adressen blev nedlagt eller henlagt, og er null for gældende og foreløbige adresser.

Alle versioner af én adresse får du med /historik/adresser?id=… eller /historik/adgangsadresser?id=…. Som i DAWA får du en liste af versioner med virkningstart, virkningslut, status og adressefelterne for den version. Versionerne bygges ud fra vores ændringslog, som starter i juli 2026, så en adresse, der ikke er ændret siden, har én version.

Tjek de id'er, du har gemt#

Gemmer du adresse-id'er i en kundedatabase, så tjek dem jævnligt. Du kan slå op til hundrede id'er i ét kald ved at adskille dem med | i parameteren id på /adresser. Husk medtagnedlagte, ellers falder de nedlagte bare ud af svaret, og du kan ikke se forskel på "nedlagt" og "ukendt":

import os

import requests

GEMTE_IDER = [
    "0a3f50ae-b4ee-32b8-e044-0003ba298018",
    "762a9a1f-a5fb-4e47-b1b2-9fa94026bc80",
    "fec4202d-1015-425d-a3f5-5d21d03194b6",
]
STATUS = {1: "gældende", 2: "nedlagt", 3: "foreløbig", 4: "henlagt"}

r = requests.get(
    "https://api.danadresse.dk/adresser",
    params={
        "id": "|".join(GEMTE_IDER),
        "medtagnedlagte": "true",
        "struktur": "mini",
        "per_side": 100,
    },
    headers={"X-Api-Key": os.environ["DANADRESSE_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
fundet = {a["id"]: a for a in r.json()}

for adresse_id in GEMTE_IDER:
    a = fundet.get(adresse_id)
    if a is None:
        print(f"{adresse_id}: ukendt id - rens den gemte tekst med /datavask")
    elif a["status"] == 1:
        print(f"{adresse_id}: gældende - {a['betegnelse']}")
    else:
        print(f"{adresse_id}: {STATUS.get(a['status'], a['status'])} - bed kunden bekræfte adressen")

Med de tre eksempel-id'er er alle gældende:

0a3f50ae-b4ee-32b8-e044-0003ba298018: gældende - Rådhuspladsen 1, st. th, 4200 Slagelse
762a9a1f-a5fb-4e47-b1b2-9fa94026bc80: gældende - Rådhuspladsen 1, 3300 Frederiksværk
fec4202d-1015-425d-a3f5-5d21d03194b6: gældende - Strandvejen 100, 2900 Hellerup

Har du mange tusinde id'er, er det billigere at følge ændringerne end at slå alt op igen. Hent hændelser fra /replikering/haendelser?entitet=adresse eller brug webhooks. En adresse, der bliver nedlagt eller henlagt, kommer som en hændelse med operation delete. Se Hent ændringer med hændelser.

Hvad du gør med en nedlagt adresse#

Slet ikke kundens data, fordi adressen er nedlagt. Kunden bor måske samme sted, og adressen har bare fået et nyt nummer eller vejnavn. Gør i stedet sådan:

1. Markér posten, så den ikke bruges til forsendelse uden kontrol.
2. Send den tekst, du har gemt, gennem datavask. Den matcher kun gældende og foreløbige adresser, så et godt match er et bud på den nye adresse.
3. Er kategorien A, kan du foreslå den nye adresse direkte. Er den B eller C, så bed kunden bekræfte.

import os

import requests

gemt_tekst = "Strandvejen 100, 2900 Hellerup"

r = requests.get(
    "https://api.danadresse.dk/datavask/adresser",
    params={"betegnelse": gemt_tekst},
    headers={"X-Api-Key": os.environ["DANADRESSE_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
vask = r.json()
print("kategori:", vask["kategori"])
for res in vask["resultater"][:3]:
    a = res["adresse"]
    print(f"  {a['vejnavn']} {a['husnr']}, {a['postnr']} {a['postnrnavn']}  id={a['id']}")

Hvert resultat har også aktueladresse, som i DAWA. Fordi vi kun matcher gældende og foreløbige adresser, er det den samme adresse som adresse. Brug resultatlisten som vist ovenfor.

Får du 404 på /adresser/{id}, kender vi ikke id'et. Det sker typisk, hvis id'et aldrig var et DAWA- eller DAR-id, eller hvis det er blevet ændret undervejs i dit system. Behandl det som en ukendt adresse og rens den gemte tekst på samme måde.

Næste skridt#

• Hvorfor du skal gemme id'et: Gem adresse-id'et.
• Forskellen på adresse og adgangsadresse: Adresse eller adgangsadresse.
• Hold en lokal kopi opdateret: Hent ændringer med hændelser.