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ø.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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.