Adresse-API — danske adresser fra DAR i WGS84

Hvad Adresse-API’et giver dig

API til adresseopslag på danske adresser

Grundfast er et adresse API bygget som en api til adresseopslag på hele Danmarks Adresseregister: ét kald med en DAR-UUID giver dig adressen gensammensat og current-only, i stedet for de rå entitets-relationer mellem adgangsadresse, husnummer og navngiven vej. Du får betegnelse, postnummer, by, kommunekode og et WGS84-koordinat i ét fladt JSON-svar — samme datamodel som resten af de syv registre, kaldt med den samme gf_live_-nøgle.

Kender du kun teksten og ikke UUID’et, så starter et adresseopslag med DAR-native søgning (GET /v1/adresse/search) og slår derefter det fundne UUID op. Begge trin kan afprøves uden nøgle via demoerne.

Status & datakontrakt

Kald adresse-API’et i din stack

Endpointet er GET /v1/adresse/:uuid med en gf_live_-nøgle — samme auth og metering som de øvrige registre. Samme adresseopslag i cURL, TypeScript og Python:

curl -H "Authorization: Bearer gf_live_…" \
  https://api.grundfast.dk/v1/adresse/0a3f50a1-…-uuid

…og svaret, med demo-kaldet og BFE-broen for fuldstændighedens skyld:

# Live nu — Register #6 (DAR), Bearer gf_live_…:
GET /v1/adresse/0a3f50a1-...-uuid
→ 200  { adresse: {
           id: "0a3f50a1-...-uuid",
           betegnelse: "Rådhuspladsen 1, 1550 København V",
           vejnavn: "Rådhuspladsen", husnr: "1",
           postnr: "1550", postnrnavn: "København V",
           kommunekode: "0101",
           koordinat: { lon: 12.5683, lat: 55.6759 } },  # WGS84
         meta: { kilde: "Datafordeler DAR via Grundfast" } }

# Datakontrakten virker uden nøgle:
GET /v1/demo/adresse → 200 { adresse: { … }, meta: { … } }

# Adresse → ejendom (BFE) i ét ekstra kald — reverse på koordinatet:
GET /v1/jordstykker/reverse?lon=12.5683&lat=55.6759
→ 200  { bfe_nummer: 5651067, matrikelnummer: "…",
         ejerlavsnavn: "…", kommunekode: "0101", … }

Felter i svaret

Hvert adresseopslag returnerer et fladt adresse-objekt plus en meta-blok med kildeangivelse:

Parametre

GET /v1/adresse/:uuid tager UUID’et i stien og en valgfri asOf til adresse-historik med ?asOf=:

Grundfast vs. DAWA vs. rå Datafordeler

Hvad et adresseopslag giver dig hos hver kilde — kun sandfærdige krydser, ingen opfundne evner:

Hvornår skal du bruge adresse-API’et

Prøv adresse-opslag live

Skriv en dansk adresse og få hele DAR-posten — betegnelse, postnummer, by og WGS84-koordinat — kørt mod den nøglefrie demo /v1/demo/adresse-search oven på det rigtige DAR-indeks, med ægte svartid.

Se også Grundfast som DAWA-alternativ, Adresse-autocomplete, BBR-API’et og Matrikel-API’et.

Ofte stillede spørgsmål