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 konto](https://grundfast.dk/dashboard?mode=register) [Se dokumentationen](https://grundfast.dk/docs/historik)

Kaldet

- [GET /v1/bbr/ejendom/:bfe?asOf=YYYY-MM-DD](https://grundfast.dk/docs/api/bbr-ejendom)

Ortofoto © Klimadatastyrelsen · via Grundfast

Vestervangen 1, 8620 Kjellerup

Bygninger · BBR

svarede efter 4 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/4026462` Prø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](https://grundfast.dk/ejendom/4026462/vestervangen-1-8620-kjellerup)

- BygningerBBROpført 1967 · parcelhus 189 m²3 bygninger i BBR **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 4 ms i sammensætningen[Mere om Bygninger →](https://grundfast.dk/bbr-api?bfe=4026462)
- AdresserDARVestervangen 1, 8620 Kjellerup
- MatriklenGeodatastyrelsenMatr.nr. 23ap · 830 m²Kjellerup By, Hørup
- Bygnings­polygonerGeoDanmark3 omrids tegnetHvert omrids koblet til sin BBR-bygning
- Terræn og højderDHMHøjeste del 2,8 m over terræn · terræn 63,8 m o.h.Målt fra overflademodellen, ikke regnet fra etager
- ByggelinjerNaturbeskyttelses­lovenInden for skovbyggelinjenAfstanden til linjen er ikke målt
- Lokalplaner og zonerPlandataByzone · Lokalplan 24Boligområde vestervangen · Ramme 23-B-25
- JordforureningRegionerne · kommunerneIkke kortlagt forureningIkke områdeklassificeret
- StøjMiljøstyrelsenIntet kortlagt støjbånd ved adressenEn kortlagt zone når ind i grundens område · 2022 (vej og jernbane) og 2017 (lufthavn og industri) — ikke det samme som stille
- OversvømmelseKystdirektoratet · MiljøstyrelsenHverken stormflod eller lavning på grundenVandløb, grundvand og kloak er ikke med
- Ejendoms­vurderingVurderingsstyrelsen1,8 mio. kr (2024)Heraf grundværdi 490.000 kr
- Kommuner og sogneDAGISilkeborg Kommune · Region MidtjyllandHørup Sogn
- StednavneDanske StednavneBypark Grønningen · 185 m vækNaturområde
- LuftfotoKlimadatastyrelsenSlår årgangene op …

Vis alle 14 registre

[GET /v1/demo/property?bfe=4026462](https://grundfast.dk/v1/demo/property?bfe=4026462)1 kald · 14 registre · fra cache på 3 ms · sammensat kl. 18.09 på 137 ms

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 år 2001–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_fra` `virkning_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.`afkortet` `meta.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](https://grundfast.dk/docs/historik).

É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](https://grundfast.dk/docs/api/bbr-historik) **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](https://grundfast.dk/docs/api/adresse-historik) **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](https://grundfast.dk/docs/api/matrikel-historik) **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](https://grundfast.dk/bbr-api) 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", … } }
```

Vis hele svaret (29 linjer)

Hvem bruger det

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

- [Due diligence og kredit Bygningsdata, som de var registreret på handels- eller låneudbetalingsdatoen — dokumenterbart bagefter.](https://grundfast.dk/loesninger/due-diligence)
- [Miljø- og geoteknik Hvornår blev bygningen udvidet, og hvad stod der før? Versionerne viser ændringen.](https://grundfast.dk/loesninger/miljoe-og-geoteknik)
- [Proptech Vis en ejendoms udvikling uden at gemme dine egne øjebliksbilleder.](https://grundfast.dk/loesninger/proptech)

Spørgsmål

## Ofte stillede spørgsmål

### Hvad returnerer ?asOf= præcis?

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.

### Hvad er forskellen på ?asOf= og /historik?

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

### Hvilke datoer kan jeg spørge på?

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.

### Får jeg matrikel-geometrien med på en tidligere 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.

### Kommer nedrevne bygninger med i /historik?

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.

### Hvilken plan kræver historik?

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

Se også

- [BBR-API Ejendommen i dag](https://grundfast.dk/bbr-api)
- [Matrikel-API Jordstykkerne og deres grænser](https://grundfast.dk/matrikel-api)
- [Adresse-API DAR-adresser og husnumre](https://grundfast.dk/adresse-api)
- [Priser Historik er med fra Scale](https://grundfast.dk/priser)
- [Bitemporalitet Virkningstid og registreringstid forklaret](https://grundfast.dk/begreber/bitemporalitet)
- [Virkningstid og registreringstid De to tidsakser forklaret](https://grundfast.dk/begreber/virkningstid-og-registreringstid)

Begreber og guides

- [BBR](https://grundfast.dk/begreber/bbr)
- [BFE-nummer](https://grundfast.dk/begreber/bfe-nummer)

Historik-API

## Svar på, hvordan ejendommen så ud dengang

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

[Opret gratis konto](https://grundfast.dk/dashboard?mode=register) [Se priserne](https://grundfast.dk/priser)

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