Spring til indhold

Grundfast

Migrér fra DAWA

DAWA lukkede 1. oktober 2026 kl. 10. De mest brugte DAWA-endpoints har en Grundfast-udgave med de samme query-parametre, og de fleste felter hedder det samme.

Migrering i tre trin

  1. Skift base-URL og tilføj en nøgle

    Skift https://api.dataforsyningen.dk ud med https://api.grundfast.dk/v1, og send en nøgle i Authorization-headeren. Opret en gratis nøgle i dashboardet.

    bash
    # før
curl "https://api.dataforsyningen.dk/postnumre/8000"

# efter
curl "https://api.grundfast.dk/v1/postnumre/8000" \
  -H "Authorization: Bearer gf_live_..."

  2. Pak svaret ud

    Hvor DAWA returnerede et bart array, returnerer Grundfast et objekt: søgning giver { results }, reverse giver { punkt, antal, adresser }, datavask giver { kategori, antal, resultater }, og listerne giver { antal, total, … }. Du pakker ét niveau ud.

  3. Læs koordinater som lon/lat

    Adresser har koordinat: { lon, lat } i WGS84 i stedet for DAWA’s x og y. Reverse-endpoints tager stadig x, y og srid som input. Se Koordinatsystemer og geometri.

Endpoint for endpoint

DAWAGrundfastBemærk
/autocomplete/v1/autocompletetype = adresse, adgangsadresse, vejnavn eller postnummer. adresse går fra vej over husnummer til etage og dør, og hvert hit bærer sin egen type. Svaret er { type, antal, resultater: [{ type, tekst, vaerdi }] }.
/adgangsadresser/autocomplete/v1/adgangsadresser/autocompleteSamme sti og q. Har du brug for BFE-nummer og koordinat i hvert hit, så brug /v1/adresse/search.
/adresser/autocomplete/v1/adresser/autocompleteEnheder med etage og dør; adgangsadresseid lister enhederne på én adresse.
/adgangsadresser?…, /adresser?…/v1/adgangsadresser, /v1/adresserSamme filtre, inkl. cirkel, polygon og srid (4326/25832), og format=geojson. Mindst ét forankrende filter; sidevis med per_side og side.
/jordstykker/reverse/v1/jordstykker/reversePunkt → jordstykket, med BFE-nummer. Broen fra adresse til ejendom.
/jordstykker?ejerlavkode=&matrikelnr=/v1/jordstykkerSamme parametre. Jordstykke, BFE og ejerlavsnavn.
/adgangsadresser/reverse/v1/adgangsadresser/reverselon/lat eller DAWA’s x/y/srid. Nærmeste først, med afstand.
/datavask/adgangsadresser/v1/datavask/adgangsadresserSamme betegnelse. Rangerede kandidater og A/B/C-kategori.
/postnumre/v1/postnumreListe, opslag og autocomplete.
/vejnavne/v1/vejnavneSideinddelt; kan afgrænses med kommunekode.
/ejerlav/v1/ejerlavListe, opslag og autocomplete.
/kommuner, /regioner, /sogne m.fl./v1/dagi/:temaTemaerne region, kommune, sogn, retskreds, politikreds og opstillingskreds.
/adgangsadresser/{id}/v1/adresse/:uuidTager både adresse- og adgangsadresse-UUID’er.
— (BBR via andre tjenester)/v1/bbr/ejendom/:bfeHele ejendommen på BFE: bygninger, enheder, jordstykker og vurdering.

Felt for felt

For en adgangsadresse. DAWA-kolonnen viser feltnavnene i struktur=mini og i autocomplete-hittets adgangsadresse; Grundfast-kolonnen er et hit fra /v1/adresse/search.

DAWAGrundfastBemærk
betegnelse (autocomplete: tekst)betegnelseHele adresselinjen, fx "Rådhuspladsen 1, 9300 Sæby".
idadgangsadresse_idDen samme UUID. Kan gemmes som nøgle.
vejnavnvejnavnUændret.
husnrhusnrUændret, inkl. bogstav ("12B").
postnrpostnrUændret, som streng.
postnrnavnpostnrnavnUændret.
kommunekodekommunekodeUændret, fire cifre som streng.
x, ykoordinat.lon, koordinat.latEt navngivet objekt i WGS84.
—bfe_nummerNyt: BFE for jordstykket under adressen — vejen videre til BBR og Matriklen.

Forskelle, du skal kende

  • Nøgle påkrævet. DAWA var åbent. Grundfast kræver Authorization: Bearer gf_live_... på alle data-endpoints; uden nøgle svarer API’et 401.
  • Svaret er pakket ind. Et objekt med resultatlisten indeni i stedet for et bart array. Resten af felterne hedder for det meste det samme.
  • Autocomplete har sin egen form. /v1/autocomplete returnerer { type, tekst, vaerdi } pr. hit, ikke DAWA’s indlejrede adgangsadresse. Har du brug for adressens felter, så brug /v1/adresse/search.
  • Kun gældende data som standard. Du får den gældende version. Skal du se bagud, tilføjer du ?asOf= på adresseopslaget — det kræver Scale-planen. Se Historik og tidsrejser.
  • 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(); // bart array

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 søgningen — eller fra /v1/jordstykker/reverse på et koordinat — å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.