Datavask-API til danske adresser

Prøv vasken live

Skriv en beskidt adresse og se den vasket op mod DAR — nøglefrit. Demoen slår op i det nøglefrie prøve-udsnit; kategori (A/B/C) og lighed lægger den fulde /v1/datavask oven på.

Datavask af kundelister

Datavask af kundelister er kerne-brugsscenariet. CRM-, ERP- og forsikringssystemer samler år efter år adresser, der er tastet i hånden — med stavefejl, forkortelser, manglende postnr og sammenskrevne ord. Grundfast vasker hver streng op mod DAR og giver dig et rangeret, autoritativt match, så du kan deduplikere, rette og berige listen i stedet for at gætte.

Adressevask mod DAR

Adressevask er datavask specifikt på adressefeltet. Du sender en fritekst-streng til GET /v1/datavask/adgangsadresser?betegnelse=…, og vasken matcher den mod Danmarks Adresseregister med trigram-lighed. Svaret bærer et A/B/C-konfidensbånd og en lighed-score pr. kandidat, så du selv bestemmer, hvornår et match er sikkert nok til at skrive tilbage.

Datavask og databerigelse i ét kald

Vasken stopper ikke ved en ren adresse. Fordi de vaskede kandidater bærer bfe_nummer, koordinat og kommunekode, får du databerigelsen med i samme svar — nøglerne til ejendommens BBR-, Matrikel- og CVR-data uden et ekstra opslag. Se databerigelse for købersiden, eller kombinér med CVR-API’et, når kundelisten er virksomheder.

Kald datavask i din stack

Samme kald i cURL, den typede TS-SDK og ren Python — én beskidt streng ind via GET /v1/datavask/adgangsadresser, og det rangerede svar nedenfor:

curl -H "Authorization: Bearer gf_live_…" \
  "https://api.grundfast.dk/v1/datavask/adgangsadresser?betegnelse=vejlebyv%2017%20vodskov"

# Datavask, Bearer gf_live_…:
GET /v1/datavask/adgangsadresser?betegnelse=vejlebyv%2017%20vodskov
→ 200  { kategori: "A", antal: 1,
         resultater: [ { betegnelse: "Vejlebyvej 17, 9310 Vodskov",
             adgangsadresse_id: "0a3f50a1-…-0003ba29abcd",
             bfe_nummer: 100450231, vejnavn: "Vejlebyvej", husnr: "17",
             postnr: "9310", postnrnavn: "Vodskov", kommunekode: "0851",
             koordinat: { lon: 10.182, lat: 57.112 }, lighed: 0.97 } ],
         meta: { kilde: "DAR via Grundfast", grundfast_version: "0.1.0" } }

kategori er DAWA-konfidensbåndet (A = sikkert, B = sandsynligt, C = usikkert), og lighed er trigram-lighed 0..1. Bemærk: et C med antal: 0 betyder, at ingen kandidat kom over lighedsgrænsen — altså intet match. Forgren derfor på antal > 0, ikke på kategori alene.

Felter i svaret

Vasken tager én parameter og returnerer et rangeret kandidat-svar:

Hvad datavask-API’et giver dig

Vask og berig en hel kundeliste

Send op til 50 adresser i ét kald med POST /v1/datavask/adgangsadresser:batch — eller loop per række gennem GET-endpointet som herunder. Kør hver adressestreng fra dit CRM, ERP eller regneark igennem, forgren på antal > 0, og behold den bedste kandidats adgangsadresse_id + bfe_nummer — så har du en vasket, beriget og dedupe-bar kundeliste:

// Vask og berig en hel kundeliste — én række ad gangen mod /v1/datavask
const BASE = 'https://api.grundfast.dk/v1/datavask/adgangsadresser';
const AUTH = { Authorization: 'Bearer gf_live_…' };

async function vaskOgBerig(kunder) {
  const beriget = [];
  for (const kunde of kunder) {
    const res = await fetch(
      `${BASE}?` + new URLSearchParams({ betegnelse: kunde.adresse }),
      { headers: AUTH },
    );
    const { kategori, antal, resultater } = await res.json();

    if (antal > 0) {
      // Bedste kandidat er allerede rangeret som resultater[0]
      const [top] = resultater;
      beriget.push({
        ...kunde,
        vasket_adresse: top.betegnelse,
        adgangsadresse_id: top.adgangsadresse_id,
        bfe_nummer: top.bfe_nummer, // bro til BBR/Matriklen (null indtil stemplet)
        match: kategori,            // A = sikkert, B = sandsynligt
      });
    } else {
      // C med antal: 0 → intet match; send til manuel gennemgang
      beriget.push({ ...kunde, match: 'ingen', bfe_nummer: null });
    }
  }
  return beriget;
}

Status & datakontrakt

Endpointet er GET /v1/datavask/adgangsadresser?betegnelse=… med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Se svar-formen under „Kald datavask i din stack“ ovenfor.

Se også Adresse-autocomplete, reverse geocoding & BFE og DAWA-alternativ.

Ofte stillede spørgsmål