Spring til indhold

Grundfast
Historik · BBR, DAR og Matriklen
Fra Scale

Ejendommen, som registret kendte den på en given dag

Sæt ?asOf= på et BBR-, adresse- eller matrikelopslag og få svaret fra dengang — eller hent alle versioner med /historik. Samme nøgle, samme svarform.

Opret gratis kontoSe dokumentationen

Kaldet

Ortofoto © Klimadatastyrelsen · via Grundfast

Vestervangen 1, 8620 Kjellerup

Bygninger · BBR

svarede efter 11 ms

Opført 1967 · parcelhus 189 m²

3 bygninger i BBR

Bygninger
3
Enheder
1
Boligareal
189 m²
Tag
Tagpap med lille hældning
GET /v1/bbr/ejendom/4026462Prøv en anden adresse

Én ejendom, live

Hvad er der sket med ejendommen?

Byggeår, om- og tilbygninger, vurderinger og luftfoto for den samme ejendom — på én tidslinje.

Søg i alle 2,7 mio. danske adresser — gratis, uden konto.

Eksempler

Byggeårfør 1900 → i dag

Parcelhus i KjellerupVestervangen 1, 8620 Kjellerup
  • Bygninger
    3
    Enheder
    1
    Boligareal
    189 m²
    Tag
    Tagpap med lille hældning
    Varme
    Fjernvarme/blokvarme
    $.bbr
    {"antal_bygninger": 3,"antal_enheder": 1,"samlet_boligareal_m2": 189,"samlet_erhvervsareal_m2": null,"hovedbygning_opfoerelsesaar": 1967,"hovedbygning_om_tilbygningsaar": null,"hovedbygning_anvendelse": "Fritliggende enfamiliehus"}
    curl "https://api.grundfast.dk/v1/bbr/ejendom/4026462" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

    svarede efter 11 ms i sammensætningenMere om Bygninger →

Vestervangen 1 gennem tiden — fra ét opslag

Bygningerne · BBR

1 bygning har intet registreret opførelsesår i BBR (BBR skriver 0 eller 1000) — de er ikke tegnet på et gæt.

Vurderinger · Vurderingsstyrelsen
22 år2001–2024
Luftfotos · Klimadatastyrelsen
Henter …+ den nyeste landsdækkende

Alt på tidslinjen kommer fra ét nøglefrit opslag på ejendommen: BBR’s opførelses- og ombygningsår for hver bygning, hele den offentlige vurderingsserie og de luftfoto-årgange, der er fløjet over den. Klik en bygning for at se den på planen. Det er ejendommens tid — ikke registrets: hvad BBR sagde på en bestemt dato, og hvornår det blev rettet, svarer ?asOf= og /historik på med en nøgle (illustreret længere nede).

Hvad du får

To tider, ét svar

Datafordelers registre er bitemporale: hvornår noget var sandt, og hvornår registret fik det at vide. Vi skjuler maskineriet og svarer på det spørgsmål, du stiller.
Et øjebliksbillede på en dato
?asOf= på det almindelige opslag giver den version, registret havde på datoen. Uden parameteren får du nutiden — samme endpoint, samme felter.?asOf=meta.as_of
Hele versionsrækken
/historik giver alle versioner, nyeste først, hver med registrerings- og virkningsinterval. Du ser selve ændringen, ikke kun resultatet.versioner[]registrering_fravirkning_fra
Ærlige grænser
Vi opdigter ikke versioner. En lang række afkortes med afkortet: true i stedet for i stilhed, og BBR-historikken siger selv, at den dækker nuværende bygninger.afkortetmeta.omfang

Registrets tid · illustration

Hvad ?asOf= svarer, når datoen flytter sig

Ejendommens tid står på planen ovenfor. Registrets tid er noget andet: hvad BBR vidste på en dato. Figuren er et konstrueret eksempel på mekanikken — én bygning, én ændring — ikke en rigtig ejendom; de målte svar kræver en nøgle. Se dokumentationen.

Én bygning, to versioner

GET /v1/bbr/ejendom/:bfe?asOf=2018-05-15

eksempel
I virkeligheden
96 m²
118 m²
I registret
v1 · 96 m²
v2 · 118 m²
2015201820212024

?asOf=2018-05-15 →

areal.samlet_boligareal_m2: 96, om_tilbygningsaar: null

meta.as_of: "2018-05-15T00:00:00.000Z"

Udvidelsen var færdig 01.03.2018, men blev først registreret 02.07.2018. Den 15.05.2018 vidste registret det ikke endnu — så svaret er stadig 96 m².

Illustration af mekanikken, ikke en rigtig bygning. ?asOf= læser registret, som det så ud på datoen: registreringstid = virkningstid = din dato.

Tre registre

Samme mønster på BBR, DAR og Matriklen

  • BBR — ejendom

    Bygningerne med de felter, versionerne bærer: anvendelse, år, etager, areal, materialer, varme. Adresser på datoen; ingen ejeroplysninger.

    Se endpointet i dokumentationen
    På en dato
    GET /v1/bbr/ejendom/:bfe?asOf=
    Alle versioner
    GET /v1/bbr/ejendom/:bfe/historik

  • DAR — adresse

    Adressen eller husnummeret, som DAR havde det på datoen.

    Se endpointet i dokumentationen
    På en dato
    GET /v1/adresse/:uuid?asOf=
    Alle versioner
    GET /v1/adresse/:uuid/historik

  • Matriklen — jordstykker

    Jordstykkerne på datoen — med geometrien fra samme tidspunkt, når den kan findes. /historik er attributter.

    Se endpointet i dokumentationen
    På en dato
    GET /v1/matrikel/ejendom/:bfe?asOf=
    Alle versioner
    GET /v1/matrikel/ejendom/:bfe/historik

Kald det

En parameter eller en sti

Med en nøgle på Scale-planen eller højere. Datoen kan være en dag eller et tidspunkt. Uden ?asOf= svarer BBR-opslaget som altid.
# Ejendommen, som BBR havde den registreret 1. januar 2019:
curl -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  "https://api.grundfast.dk/v1/bbr/ejendom/5651067?asOf=2019-01-01"

# Alle versioner af hver bygning:
curl -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  https://api.grundfast.dk/v1/bbr/ejendom/5651067/historik

Svarets form

GET /v1/bbr/ejendom/5651067/historik
→ 200
{
  type: "bbr_historik",
  bfe_nummer: 5651067,
  bygninger: [
    {
      id: "…",
      versioner: [                         // nyeste først
        {
          registrering_fra: "…", registrering_til: null,
          virkning_fra: "…",     virkning_til: null,
          bygningsnummer: 1,
          anvendelse: { kode: "…", tekst: "…" },
          opfoerelsesaar: …, om_tilbygningsaar: …, antal_etager: …,
          areal: { … }, materialer: { ydervaeg: { … }, tag: { … } }, varme: { … }
        },
        { registrering_fra: "…", registrering_til: "…", … }
      ],
      afkortet: false
    }
  ],
  afkortet: false,
  meta: { kilde: "Datafordeler BBR via Grundfast", omfang: "aktuelle_bygninger", … }
}

// Et punkt i tiden på det almindelige opslag — datoen ekko'es som tidsstempel:
GET /v1/bbr/ejendom/5651067?asOf=2019-01-01
→ 200  { type: "ejendom", bygninger: [ … ], meta: { as_of: "2019-01-01T00:00:00.000Z", … } }

Hvem bruger det

Når spørgsmålet er “hvad vidste man dengang?”

Spørgsmål

Ofte stillede spørgsmål

Posten, som registret havde den registreret på datoen: vi spørger Datafordeler med registreringstid og virkningstid sat til din dato. Er en ændring sket i virkeligheden, men endnu ikke registreret, får du den gamle version — det er det, registret vidste. Datoen ekko’es i meta.as_of som et fuldt tidsstempel.

?asOf= giver ét øjebliksbillede på en dato, du kender. /historik giver alle versioner med deres registrerings- og virkningsintervaller, så du kan finde selve ændringstidspunktet.

En ISO-dato eller et tidspunkt fra 1990 og frem til i dag. En dato i fremtiden afvises med 400 i stedet for at svare med nutidens data under en fremtidig dato.

Ja, når den kan findes: ?asOf= på Matriklen henter jordstykkernes flader fra samme tidspunkt og sætter dem på svaret. Kan fladen ikke hentes, får du jordstykkets attributter med geometri null — aldrig en nutidig grænse under en gammel dato.

Nej. BBR-historikken følger de bygninger, der står på ejendommen i dag (meta.omfang: "aktuelle_bygninger"). En bygning, der er revet ned, har ingen tidslinje her.

?asOf= og /historik er med fra Scale-planen. De almindelige opslag uden ?asOf= er med på alle planer.

Se også

Begreber og guides

Historik-API

Svar på, hvordan ejendommen så ud dengang

Opret en nøgle og sæt ?asOf= på dit første opslag.
Opret gratis kontoSe priserne

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