Spring til indhold

Grundfast

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.

På denne side· 5 afsnit

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

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

StierBemærk
/adgangsadresser, /adgangsadresser/{id}, /adgangsadresser/autocomplete, /adgangsadresser/reverse, /reverseFiltre 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/reverseEnheder med etage og dør; samme filtre plus adgangsadresseid, etage og dør. reverse giver den første enhed på den nærmeste adgangsadresse.
/autocompleteVejnavn → 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/reverseMed kommunerne pr. postnummer. reverse slår punktet op i DAGI’s postnummerinddeling.
/vejnavne, /vejnavne/{navn}, /vejnavne/autocompleteHvert vejnavn med postnumre og kommuner.
/vejstykker, /vejstykker/{kommunekode}/{kode}, /vejstykker/autocomplete, /vejstykker/{kommunekode}/{kode}/naboerVejkode, navn, adresseringsnavn og navngiven vej pr. kommune, med postnumre. naboer måles på de navngivne vejes geometri.
/navngivneveje, /navngivneveje/{id}, /navngivneveje/autocomplete, /navngivneveje/{id}/naboerDen 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/reverseBegge 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 /reversereverse slår punktet op i DAGI.
/storkredse, /valglandsdele, /landsdele, /afstemningsomraader — hver med opslag, /autocomplete og /reverseAfstemningsområ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/autocompleteMed bfenummer. Listen kræver ejerlavkode, kommunekode eller bfenummer. autocomplete tager "matrikelnummer [ejerlav]", fx "12a Vridsløselille".
/replikering/senestesekvensnummer, /replikering/adgangsadresser/haendelserHændelser for adgangsadresser — se Replikering.
/replikering/adgangsadresser, /replikering/adresser, /replikering/vejstykker, /replikering/postnumreUdtræ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).
  • 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.

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

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