Spring til indhold

Grundfast

Versionshistorik for en ejendom

Den fulde registreringshistorik for hver af ejendommens nuværende bygninger, nyeste version først og med de fire bitemporale tidsstempler.

GET/v1/bbr/ejendom/{bfe}/historik

BBR er bitemporalt: hver version har et registreringsvindue (hvornår registret noterede oplysningen) og et virkningsvindue (hvornår den gjaldt i virkeligheden). Svaret giver én tidslinje pr. bygning, og hver version bærer de værdier, der var registreret dengang — anvendelse, opførelsesår, etager, arealer, materialer og varme.

Kun bygninger, der findes i den nuværende registrering, får deres historik gennemgået (meta.omfang er altid aktuelle_bygninger). En nedrevet eller erstattet bygning er derfor ikke med. Vil du se hele ejendommen på en bestemt dato, så brug asOf på Hent en ejendom.

Historikken hentes live fra Datafordeler og caches ikke, så kaldet er langsommere end et almindeligt opslag. Der gennemgås højst 25 bygninger og 60 versioner pr. bygning; en afkortning står altid i afkortet.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Kræver Scale-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

Ét kald, uanset hvor mange bygninger og versioner svaret indeholder.

Eksempel

curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067/historik" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "type": "bbr_historik",
  "bfe_nummer": 5651067,
  "bygninger": [
    {
      "id": "c7e65d4a-0c66-4838-9b19-728abbeddd71",
      "versioner": [
        {
          "registrering_fra": "2021-03-09T10:14:27.000Z",
          "registrering_til": null,
          "virkning_fra": "2021-03-09T10:14:27.000Z",
          "virkning_til": null,
          "bygningsnummer": 1,
          "anvendelse": {
            "kode": "120",
            "tekst": "Fritliggende enfamiliehus"
          },
          "opfoerelsesaar": 1958,
          "om_tilbygningsaar": null,
          "antal_etager": 1,
          "areal": {
            "bebygget_m2": 116,
            "samlet_bygningsareal_m2": 116,
            "samlet_boligareal_m2": 95,
            "samlet_erhvervsareal_m2": null
          },
          "materialer": {
            "ydervaeg": {
              "kode": "1",
              "tekst": "Mursten"
            },
            "tag": {
              "kode": "5",
              "tekst": "Tegl"
            }
          },
          "varme": {
            "installation": {
              "kode": "1",
              "tekst": "Fjernvarme/blokvarme"
            },
            "opvarmningsmiddel": null,
            "supplerende": null
          }
        },
        {
          "registrering_fra": "2016-11-22T08:41:05.000Z",
          "registrering_til": "2021-03-09T10:14:27.000Z",
          "virkning_fra": "2016-11-22T08:41:05.000Z",
          "virkning_til": "2021-03-09T10:14:27.000Z",
          "bygningsnummer": 1,
          "anvendelse": {
            "kode": "120",
            "tekst": "Fritliggende enfamiliehus"
          },
          "opfoerelsesaar": 1958,
          "om_tilbygningsaar": null,
          "antal_etager": 1,
          "areal": {
            "bebygget_m2": 112,
            "samlet_bygningsareal_m2": 112,
            "samlet_boligareal_m2": 92,
            "samlet_erhvervsareal_m2": null
          },
          "materialer": {
            "ydervaeg": {
              "kode": "1",
              "tekst": "Mursten"
            },
            "tag": {
              "kode": "5",
              "tekst": "Tegl"
            }
          },
          "varme": {
            "installation": {
              "kode": "1",
              "tekst": "Fjernvarme/blokvarme"
            },
            "opvarmningsmiddel": null,
            "supplerende": null
          }
        }
      ],
      "afkortet": false
    }
  ],
  "afkortet": false,
  "meta": {
    "kilde": "Datafordeler BBR via Grundfast",
    "grundfast_version": "0.1.0",
    "omfang": "aktuelle_bygninger"
  }
}

Parametre

bfeintegerstipåkrævet
BFE-nummeret på den ejendom, hvis bygningshistorik du vil have.Eksempel: 5651067

Felter i svaret

bygninger[].versionerobject[]
Bygningens versioner, nyeste først, hver med de værdier der var registreret i den version.
bygninger[].versioner[].registrering_frastring | null
Hvornår versionen blev registreret. registrering_til og virkning_til er null på den gældende version.
bygninger[].versioner[].virkning_frastring | null
Hvornår oplysningen fik virkning i virkeligheden — ikke nødvendigvis samme dag som registreringen.
bygninger[].afkortetboolean
true når bygningen har flere end 60 versioner; de ældste er udeladt.
afkortetboolean
true når ejendommen har flere end 25 bygninger; de resterende er udeladt.

Statuskoder

StatusBetydning
200Svaret er leveret.
400BFE-nummeret er ikke et positivt heltal.
401Nøglen mangler eller er ugyldig.
402Planen er under Scale.
404BFE-nummeret findes ikke i BBR, eller ejendommen har ingen nuværende bygninger at følge.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Datafordeler fejlede under gennemgangen. Historik serveres aldrig fra cache.
503Kilden er ikke konfigureret i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

GET /v1/bbr/ejendom/5651067/historik

Bruges ofte sammen med

Læs mere om BBR, og hvad data kan bruges til, på produktsiden.