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
Skift base-URL og tilføj en nøgle
Skift
https://api.dataforsyningen.dkud medhttps://api.grundfast.dk/dawa, og send en nøgle iAuthorization: Bearer …— eller som?token=, hvis dit system kun kan sætte en URL. Opret en gratis nøgle i dashboardet. Stier, parametre og svar er DAWA’s egne: bare arrays og objekter,struktur=nestet|mini|flad,format=json|geojson|csv,srid,per_side/sideog JSONP viacallback.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_..."Tjek de felter, du læser
Nogle felter kan ikke længere udfyldes efter DAWA og er altid
null— se DAWA efter DAWA nedenfor. Læser din kode dem, skal den tålenull.
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.
/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. |
| /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/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,brofastogzonepå adresser.stormodtagerpostnr,stormodtagerpostnrnavnogstormodtagerpostnummer. Parameterenstormodtagerpostnumretages imod, men gør ingenting.- Det gamle BBR-ejerlav:
ejerlav,ejerlavkode,ejerlavnavn,matrikelnrogesrejendomsnr. Brugjordstykke, som har ejerlav og matrikelnummer fra Matriklen. - Historikdatoerne
oprettet,ikrafttrædelseognedlagt.ændreter udfyldt. menighedsrådsafstemningsområdeogbebyggelserpå adresser.- Navngivne vejes
retskrivningskontrolog historikdatoerneoprettet,ikrafttrædelseognedlagt. - DAGI-temaernes geometrioplysninger:
ændret,geo_ændret,geo_version,bboxogvisueltcenter. - Postnumrenes
stormodtageradresserogbbox, og vejstykkernesoprettetognedlagt.
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_sidesvarer med hele listen, som i DAWA. Over 10.000 rækker sendes den løbende, mens den læses, og headerenX-Total-Countsiger, 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_sidetæ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 den429, 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_sideer 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/haendelserog/replikering/senestesekvensnummerkommer 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.
txider tidsstemplet på det DAR-udtræk, ændringen kom fra. En nedlagt adresse er endelete.- 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 (
400for en forkert parameter,404for en ukendt nøgle), men kroppen er Grundfasts fejlformat:{ "error", "type", "code", "message", "request_id", "doc_url" }(se Fejl og statuskoder). fuzzytages 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 iX-Quota-*; begge svarer429medRetry-After. Se Rate limits og kvoter.
Før og efter
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ængdegradFra 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.
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. Baggrund og tidsplan for lukningen står på DAWA-alternativ.