Spring til indhold

Grundfast
BBR · Matriklen · Vurdering · CVR

Databerigelse med BBR, CVR og vurdering

Har I en liste over kunder, lejemål eller ejendomme? Hver adresse bliver til et BFE-nummer, og det åbner bygningen i BBR, grunden i Matriklen og den offentlige vurdering — og CVR, hvor rækken er en virksomhed. Én nøgle til det hele.

GET/v1/demo/property
klar

Kundeliste → ejendomsdata

AdresseBygningOpførtVurdering

solbakkevej 70 silkeborg

vasker

nyhavn 20, kbh k

vasker

Rådhuspladsen 1, 1550 København V

vasker

aaboulevarden 1 aarhus

vasker

Hver række er rigtige opslag: adressen vaskes mod DAR, og ejendommen under den hentes. Med din nøgle er det tre kald — /v1/datavask/adgangsadresser, /v1/bbr/ejendom/:bfe og /v1/vurdering/:bfe — og vask og BBR tager 50 ad gangen fra Pro.

Kolonnerne

Det, hver række kan få med

Kolonnerne herunder kommer fra hver sit register, men nøglen er den samme: BFE-nummeret fra datavasken. Feltnavnene er API’ets egne.

Kolonner til en beriget liste
KolonneFelt i svaretRegister
BFE-nummerresultater[0].bfe_nummerDatavask (DAR)
Opførelses- og om-/tilbygningsårbygninger[].opfoerelsesaar · om_tilbygningsaarBBR
Anvendelsebygninger[].anvendelse.tekstBBR
Bolig- og erhvervsarealbygninger[].areal.samlet_boligareal_m2 · samlet_erhvervsareal_m2BBR
Tag, ydervæg og varmebygninger[].materialer.tag.tekst · ydervaeg.tekst · varme.installation.tekstBBR
Matrikelnummer, ejerlav og grundarealjordstykker[].matrikelnummer · ejerlav.navn · areal_m2Matriklen
Ejendoms- og grundværdiseneste.ejendomsvaerdi_kr · grundvaerdi_kr · aarVurdering
Kommune og regiondagi.kommune.navn · dagi.region.navnDAGI
Virksomhed, branche og statusvirksomhed.navn · branche.tekst · statusCVR

Opskriften

Tre kald pr. række, i bunker af 50

Vask adresserne, hent bygningerne i BBR og vurderingen pr. BFE. Vask og BBR tager 50 ad gangen fra Pro-planen; på de andre planer er det de samme kald, én række ad gangen.

berig_kundeliste.pypython
import csv, requests

API = "https://api.grundfast.dk/v1"
H = {"Authorization": "Bearer gf_live_…"}

def bidder(xs, n=50):
    for i in range(0, len(xs), n):
        yield xs[i : i + n]

rows = list(csv.DictReader(open("kunder.csv", newline="")))

for bid in bidder(rows):
    # 1) Vask adresserne → BFE-nummer (ét kald pr. unik adresse)
    adresser = sorted({r["adresse"].strip() for r in bid if len(r["adresse"].strip()) >= 2})
    vask = requests.post(f"{API}/datavask/adgangsadresser:batch", headers=H,
                         json={"betegnelser": adresser}).json()
    pr_adresse = {v["input"]: v for v in vask["results"]}
    for row in bid:
        v = pr_adresse.get(row["adresse"].strip())
        row["bfe"] = v["resultater"][0]["bfe_nummer"] if v and v["antal"] else None

    # 2) BFE → bygningerne i BBR, 50 ejendomme pr. kald
    bfer = sorted({r["bfe"] for r in bid if r["bfe"]})
    ejendomme = {}
    if bfer:
        bbr = requests.post(f"{API}/bbr/ejendom:batch", headers=H, json={"bfe": bfer}).json()
        ejendomme = {e["bfe"]: e["ejendom"] for e in bbr["results"]}

    for row in bid:
        e = ejendomme.get(row["bfe"])
        i = e["hovedbygning_index"] if e else None
        hoved = e["bygninger"][i] if i is not None else {}
        row["opfoert"] = hoved.get("opfoerelsesaar")
        row["anvendelse"] = (hoved.get("anvendelse") or {}).get("tekst")
        # 3) BFE → den offentlige vurdering
        if row["bfe"]:
            vur = requests.get(f"{API}/vurdering/{row['bfe']}", headers=H).json()
            row["ejendomsvaerdi"] = (vur.get("seneste") or {}).get("ejendomsvaerdi_kr")
Pr. række
3 kald: vask, BBR og vurdering
1.000 rækker
3.000 kald
Free
ca. 1.666 rækker om måneden
Starter
ca. 33.333 rækker om måneden

Et batch-kald tæller én gang pr. række — dubletter kun én gang — så en bunke på 50 koster aldrig mere end 50 enkeltkald. Se alle planer på priser.

Spørgsmål

Ofte stillede spørgsmål

Datavasken gør adressen rigtig og finder ejendommens BFE-nummer. Databerigelsen bruger BFE-nummeret til at hente det, rækken ikke havde: bygningen fra BBR, grunden fra Matriklen, den offentlige vurdering og — hvor rækken er en virksomhed — CVR.

Opskriften på siden bruger 3 kald pr. række: vask, BBR og vurdering. 1.000 rækker er altså 3.000 kald. Free-planens 5.000 kald rækker til omkring 1.666 rækker om måneden, Starter til 33.333. Batch-kaldene er med fra Pro-planen og koster det samme pr. række.

BBR-svaret har alle bygninger på ejendommen i bygninger[] og peger på hovedbygningen med hovedbygning_index. Vil I have én værdi pr. række, så tag hovedbygningen; vil I have totaler, så læg arealerne sammen over listen.

Nej. Ejerfortegnelsen udstiller vi ikke i dag, så en række får ikke ejerens navn. Er ejeren en virksomhed, og kender I CVR-nummeret, kan I berige med virksomhedens navn, branche og status fra CVR.

Ja, når I har CVR-numrene: /v1/cvr/:cvr giver navn, status, branche og beliggenhedsadresse, og adressen kan vaskes videre til BFE-nummer og ejendom. Opslag sker på CVR-nummer — søgning på virksomhedsnavn er ikke åben.

Svarene kommer fra registrene på Datafordeleren. Er et register nede, svarer vi fra vores seneste kopi og siger det i headeren X-Grundfast-Stale, så I kan vælge at prøve rækken igen senere.

Se også

Databerigelse

Berig de første rækker i dag

Opret en gratis konto, lav en API-nøgle, og prøv opskriften på et udsnit af jeres liste. Samme nøgle til vask, BBR, matrikel, vurdering og CVR.

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0