# status, darstatus og nedlagte adresser

> Forstå felterne status og darstatus, hvornår nedlagte adresser er med i svaret, og hvad du gør med gemte adresse-id'er, der ikke længere er gældende.
>
> https://danadresse.dk/guides/status-og-darstatus · verified 2026-11-02
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å:

| `status` | Betydning |
|---|---|
| 1 | Gældende. Adressen er i brug |
| 2 | Nedlagt. Adressen har eksisteret, men er ikke længere i brug |
| 3 | Foreløbig. Adressen er oprettet, men endnu ikke endelig |
| 4 | Henlagt. Adressen blev oprettet som foreløbig og aldrig taget i brug |

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

| `darstatus` | Betydning |
|---|---|
| 2 | Foreløbig |
| 3 | Gældende |
| 4 | Nedlagt |
| 5 | Henlagt |

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

| Endpoint | Hvilke adresser |
|---|---|
| `/autocomplete`, `/adresser/autocomplete` | Gældende og foreløbige |
| `/adresser`, `/adgangsadresser` (lister) | Gældende og foreløbige, medmindre du sender `status` eller `medtagnedlagte` |
| `/adresser/{id}`, `/adgangsadresser/{id}` | Adressen med det id, uanset status. Et adresse-id på `/adgangsadresser/{id}` giver dens adgangsadresse |
| `/adresser/reverse`, `/adgangsadresser/reverse` | Gældende og foreløbige |
| `/datavask/adresser`, `/datavask/adgangsadresser` | Gældende og foreløbige kandidater |
| `cirkel=` og `polygon=` på listerne | Som listerne: gældende og foreløbige, værdien i `status` eller det hele med `medtagnedlagte` |

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":

```python id=check-stored run=live expect="gældende"
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:

```text id=check-stored-output run=no
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](/guides/replikering-haendelser).

## 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.

```python id=find-replacement run=live expect="kategori"
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](/guides/gem-adresse-id).
- Forskellen på adresse og adgangsadresse: [Adresse eller adgangsadresse](/guides/adresse-vs-adgangsadresse).
- Hold en lokal kopi opdateret: [Hent ændringer med hændelser](/guides/replikering-haendelser).