# Versionshistorik for en ejendom

`GET /v1/bbr/ejendom/:bfe/historik` · BBR

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

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](https://grundfast.dk/docs/api/bbr-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:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Scale-planen

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

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | path | integer | ja | BFE-nummeret på den ejendom, hvis bygningshistorik du vil have. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/bbr/ejendom/5651067/historik" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "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"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `bygninger[].versioner` | object[] | Bygningens versioner, nyeste først, hver med de værdier der var registreret i den version. |
| `bygninger[].versioner[].registrering_fra` | string \| null | Hvornår versionen blev registreret. `registrering_til` og `virkning_til` er `null` på den gældende version. |
| `bygninger[].versioner[].virkning_fra` | string \| null | Hvornår oplysningen fik virkning i virkeligheden — ikke nødvendigvis samme dag som registreringen. |
| `bygninger[].afkortet` | boolean | `true` når bygningen har flere end 60 versioner; de ældste er udeladt. |
| `afkortet` | boolean | `true` når ejendommen har flere end 25 bygninger; de resterende er udeladt. |

## Fejl

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