# Migrér fra DAWA

DAWA lukkede 1. oktober 2026 kl. 10. Under https://api.grundfast.dk/dawa svarer Grundfast med DAWA’s egne stier, parametre og svar, så eksisterende kode virker med en ny base-URL og en nøgle.

## Migrering i to trin

1. **Skift base-URL og tilføj en nøgle** — Skift `https://api.dataforsyningen.dk` ud med `https://api.grundfast.dk/dawa`, og send en nøgle i `Authorization: Bearer …` — eller som `?token=`, hvis dit system kun kan sætte en URL. Opret en gratis nøgle i [dashboardet](https://grundfast.dk/dashboard?mode=register). Stier, parametre og svar er DAWA’s egne: bare arrays og objekter, `struktur=nestet|mini|flad`, `format=json|geojson|csv`, `srid`, `per_side`/`side` og JSONP via `callback`.

```bash
# før
curl "https://api.dataforsyningen.dk/adgangsadresser?postnr=8000&per_side=10"

# efter
curl "https://api.grundfast.dk/dawa/adgangsadresser?postnr=8000&per_side=10" \
  -H "Authorization: Bearer gf_live_..."
```

2. **Tjek de felter, du læser** — Nogle felter kan ikke længere udfyldes efter DAWA og er altid `null` — se [DAWA efter DAWA](#dawa-efter-dawa) nedenfor. Læser din kode dem, skal den tåle `null`.

Bruger du npm-pakken `dawa-autocomplete2` til et adressefelt, så er der en afløser med samme funktion og indstillinger: se [Skift dawa-autocomplete2 ud](https://grundfast.dk/docs/dawa-autocomplete2).

> `/dawa` er til kode, der allerede taler DAWA. Skriver du nyt, så kig også på vores eget API under `/v1`: det giver BFE-nummeret i hvert adressehit og fører videre til BBR, Matriklen og vurdering med samme nøgle.

## Endpoints under /dawa

Alle stier herunder findes under `https://api.grundfast.dk/dawa` med samme navn og parametre som i DAWA. Hvert kald tæller som ét kald, ligesom under `/v1`.

| Stier | Bemærk |
| --- | --- |
| /adgangsadresser, /adgangsadresser/{id}, /adgangsadresser/autocomplete, /adgangsadresser/reverse, /reverse | Filtre som i DAWA: q, id, kommunekode, vejkode, vejnavn, husnr, supplerendebynavn, postnr, sognekode, opstillingskredskode, retskredskode, politikredskode, afstemningsområdenummer, navngivenvej_id, ejerlavkode + matrikelnr, status, cirkel og polygon. Flere værdier adskilles med `\|`. reverse (og aliaset /reverse) giver den nærmeste adresse. `include=bbr` lægger bygningerne på adressen ved — se [BBR på adressen](#include-bbr). |
| /adresser, /adresser/{id}, /adresser/autocomplete, /adresser/reverse | Enheder med etage og dør; samme filtre plus adgangsadresseid, etage og dør. reverse giver den første enhed på den nærmeste adgangsadresse. |
| /autocomplete | Vejnavn → adgangsadresse → adresse med type, tekst, forslagstekst, caretpos og data; caretpos, type, startfra, adgangsadresseid, kommunekode, postnr, supplerendebynavn og multilinje virker. |
| /datavask/adgangsadresser, /datavask/adresser | `{ kategori, resultater }` med A/B/C, adresse, aktueladresse og vaskeresultat. |
| /postnumre, /postnumre/{nr}, /postnumre/autocomplete, /postnumre/reverse | Med kommunerne pr. postnummer. reverse slår punktet op i DAGI’s postnummerinddeling. |
| /vejnavne, /vejnavne/{navn}, /vejnavne/autocomplete | Hvert vejnavn med postnumre og kommuner. |
| /vejstykker, /vejstykker/{kommunekode}/{kode}, /vejstykker/autocomplete, /vejstykker/{kommunekode}/{kode}/naboer | Vejkode, navn, adresseringsnavn og navngiven vej pr. kommune, med postnumre. naboer måles på de navngivne vejes geometri. |
| /navngivneveje, /navngivneveje/{id}, /navngivneveje/autocomplete, /navngivneveje/{id}/naboer | Den navngivne vej på tværs af kommuner med vejstykker, postnumre og DAR’s vejnavnelinje (format=geojson, geometri=vejnavnelinje\|vejnavneområde\|begge). naboer tager afstand i meter (standard 0 = veje, der rører hinanden, højst 500). |
| /supplerendebynavne, /supplerendebynavne/{navn}, /supplerendebynavne2, /supplerendebynavne2/{dagi_id}, …/autocomplete, /supplerendebynavne2/reverse | Begge DAWA’s former: den gamle på navn og den DAGI-nøglede med kommune og postnumre — de supplerende bynavne, en gældende adresse bruger. |
| /kommuner, /regioner, /sogne, /retskredse, /politikredse, /opstillingskredse — hver med /{kode}, /autocomplete og /reverse | reverse slår punktet op i DAGI. |
| /storkredse, /valglandsdele, /landsdele, /afstemningsomraader — hver med opslag, /autocomplete og /reverse | Afstemningsområder slås op på /{kommunekode}/{nummer} og har afstemningsstedet med adresse. Landsdele slås op på NUTS-3-koden. |
| /stormodtagere, /stormodtagere/{nr} | De historiske stormodtager-postnumre. |
| /bebyggelser, /bebyggelser/{id} | Byer, bydele, sommerhusområder m.fl. fra Danske Stednavne med polygon (format=geojson); x og y giver de bebyggelser, punktet ligger i. |
| /ejerlav, /ejerlav/{kode}, /ejerlav/autocomplete | — |
| /jordstykker, /jordstykker/{ejerlavkode}/{matrikelnr}, /jordstykker/reverse, /jordstykker/autocomplete | Med bfenummer. Listen kræver ejerlavkode, kommunekode eller bfenummer. autocomplete tager "matrikelnummer [ejerlav]", fx "12a Vridsløselille". |
| /replikering/senestesekvensnummer, /replikering/adgangsadresser/haendelser | Hændelser for adgangsadresser — se [Replikering](#replikering). |
| /replikering/adgangsadresser, /replikering/adresser, /replikering/vejstykker, /replikering/postnumre | Udtræk af de aktuelle data, sidevis. |
| /replikering/udtraek?entitet=, /replikering/haendelser?entitet= | Den samlede form; entitet = adgangsadresse, adresse, vejstykke eller postnummer. |

Ikke med under `/dawa`: stednavne, bygninger og menighedsrådsafstemningsområder (DAGI udgiver dem ikke længere; stien svarer 404 og siger hvorfor).

### BBR på adressen

DAWA havde ikke BBR med. Sæt `include=bbr` på /adgangsadresser og /adresser (liste, id og reverse), så får hvert adresseobjekt feltet `bbr: { bygninger: [...] }` med de opførte bygninger på adressen — anvendelse, opførelsesår, arealer, etager, varme, tag, ydervæg, asbest og energimærke, med koderne oversat og største bygning først. En tom liste betyder, at BBR ikke har en opført bygning på adressen. Højst 100 adresser pr. svar og ikke i CSV; uden parameteren er svaret DAWA’s, uændret.

## DAWA efter DAWA

Svarene har DAWA’s felter, i DAWA’s rækkefølge. Men DAWA byggede nogle af dem på kilder, der ikke findes længere, eller som ikke er en del af DAR. Det her er forskellene.

### Felter, der altid er null

- `højde`, `brofast` og `zone` på adresser.
- `stormodtagerpostnr`, `stormodtagerpostnrnavn` og `stormodtagerpostnummer`. Parameteren `stormodtagerpostnumre` tages imod, men gør ingenting.
- Det gamle BBR-ejerlav: `ejerlav`, `ejerlavkode`, `ejerlavnavn`, `matrikelnr` og `esrejendomsnr`. Brug `jordstykke`, som har ejerlav og matrikelnummer fra Matriklen.
- Historikdatoerne `oprettet`, `ikrafttrædelse` og `nedlagt`. `ændret` er udfyldt.
- `menighedsrådsafstemningsområde` og `bebyggelser` på adresser.
- Navngivne vejes `retskrivningskontrol` og historikdatoerne `oprettet`, `ikrafttrædelse` og `nedlagt`.
- DAGI-temaernes geometrioplysninger: `ændret`, `geo_ændret`, `geo_version`, `bbox` og `visueltcenter`.
- Postnumrenes `stormodtageradresser` og `bbox`, og vejstykkernes `oprettet` og `nedlagt`.

### DAGI på adressen

Sogn, afstemningsområde, opstillingskreds, storkreds, valglandsdel, region, landsdel, retskreds og politikreds kommer fra DAR’s egne henvisninger til DAGI og slås op, når adresseindekset bygges — ikke ved hvert kald. Retskreds og politikreds følger kommunen; i Københavns Kommune, der er delt mellem to retskredse, afgør adgangspunktet retskredsen.

### Grænser

- En liste uden `per_side` svarer med hele listen, som i DAWA. Over 10.000 rækker sendes den løbende, mens den læses, og headeren `X-Total-Count` siger, hvor mange rækker der kommer. Svaret er byte for byte det samme som et samlet svar. Afbrydes en løbende liste undervejs fra vores side — fx når vi udruller en ny version — ser klienten en afbrudt overførsel, aldrig en kortere liste, og kaldet koster ikke noget; hent den igen. Lukker klienten selv forbindelsen undervejs, koster kaldet de rækker, der allerede er sendt.
- En liste uden `per_side` tæller som ét kald for hver påbegyndt 1.000 rækker, mindst ét — det samme, som det koster at hente dem sidevis. Er der ikke kald nok tilbage i måneden på en plan med loft, svarer den `429`, før noget sendes.
- Hver konto kan hente én løbende liste ad gangen; en til svarer `429`, til den første er færdig.
- En filtreret liste kan højst give 1.000.000 rækker. Hele datasættet hentes fra replikeringens udtræk, som ikke har noget loft.
- Sideinddeling ud over de første 25.000 rækker afvises, som i DAWA.
- Replikeringens udtræk uden `per_side` er hele datasættet, sendt løbende i nøgleorden. Et hændelsesvindue sendes også helt, uanset hvor mange hændelser det rummer.
- Type-ahead-endpoints giver 20 forslag som standard og højst 100.

### Status

Lister giver som i DAWA de gældende og foreløbige adresser (DAR-status 3 og 2). Med `status` (1 gældende, 2 nedlagt, 3 foreløbig, 4 henlagt) eller `darstatus` (2–5) vælger du andre. Et opslag på id svarer uanset status.

### Replikering

- `/replikering/adgangsadresser/haendelser` og `/replikering/senestesekvensnummer` kommer fra vores log over adresseændringer, som bygges af den daglige DAR-opdatering. Loggen dækker adgangsadresser (husnumre) og holder 35 dage.
- Loggen registrerer ændringer i betegnelse, vejnavn, husnr, postnr, postnrnavn, kommunekode og koordinat. Felter, der ikke er med i hændelsen, viser adressen, som den ser ud nu.
- `txid` er tidsstemplet på det DAR-udtræk, ændringen kom fra. En nedlagt adresse er en `delete`.
- Adresser, vejstykker og postnumre har udtræk, men ingen hændelser — de svarer `404`.

### Øvrigt

- **Nøgle påkrævet.** Uden nøgle svarer et kald `401`. Nøglen hører hjemme på serveren, ikke i browseren.
- **Fejl** har DAWA’s statuskoder (`400` for en forkert parameter, `404` for en ukendt nøgle), men kroppen er Grundfasts fejlformat: `{ "error", "type", "code", "message", "request_id", "doc_url" }` (se [Fejl og statuskoder](https://grundfast.dk/docs/fejl)).
- **`fuzzy`** tages imod og er altid slået til: søgningen tåler stavefejl.
- **Forbrug måles.** Free-planen har 5.000 kald om måneden. Burst-grænsen står i `X-RateLimit-*` og månedens forbrug i `X-Quota-*`; begge svarer `429` med `Retry-After`. Se [Rate limits og kvoter](https://grundfast.dk/docs/rate-limits).

## Før og efter

**Før: DAWA**

```js
const q = 'rådhuspladsen 1';
const res = await fetch(
  `https://api.dataforsyningen.dk/adgangsadresser/autocomplete?q=${encodeURIComponent(q)}`,
);
const hits = await res.json();

hits[0].tekst;              // "Rådhuspladsen 1, 9300 Sæby"
hits[0].adgangsadresse.id;
hits[0].adgangsadresse.x;   // længdegrad
```

**Efter: Grundfast**

```js
const q = 'rådhuspladsen 1';
const res = await fetch(
  `https://api.grundfast.dk/dawa/adgangsadresser/autocomplete?q=${encodeURIComponent(q)}`,
  { headers: { Authorization: `Bearer ${process.env.GRUNDFAST_API_KEY}` } },
);
const hits = await res.json();

hits[0].tekst;              // "Rådhuspladsen 1, 9300 Sæby"
hits[0].adgangsadresse.id;
hits[0].adgangsadresse.x;   // længdegrad
```

## Fra adresse til ejendom

DAWA gav dig adressen. Med BFE-nummeret — fra `/v1/adresse/search`, fra `bfenummer` på `/dawa/jordstykker/reverse` eller fra `/v1/jordstykker/reverse` — åbner `/v1/bbr/ejendom/:bfe` hele ejendommen: bygninger, enheder, jordstykker og vurdering i ét kald.

```js
const headers = { Authorization: `Bearer ${process.env.GRUNDFAST_API_KEY}` };
const base = 'https://api.grundfast.dk/v1';

const { results } = await (await fetch(`${base}/adresse/search?q=r%C3%A5dhuspladsen%201`, { headers })).json();
const bfe = results[0]?.bfe_nummer;
if (bfe) {
  const ejendom = await (await fetch(`${base}/bbr/ejendom/${bfe}`, { headers })).json();
  console.log(ejendom.antal_bygninger, 'bygninger');
}
```

Kommer du også fra andre gamle Datafordeler-tjenester, så se [migreringsguiden](https://grundfast.dk/migrering). Baggrund og tidsplan for lukningen står på [DAWA-alternativ](https://grundfast.dk/dawa-alternativ).
