# Versionshistorik for jordstykker

`GET /v1/matrikel/ejendom/:bfe/historik` · Matriklen

Versionshistorikken for hvert jordstykke på en ejendom, nyeste version først og med de fire bitemporale tidsstempler.

Hver version viser jordstykket, som det var registreret i perioden: matrikelnummer, ejerlav, areal og kommunekode, med registrerings- og virkningstid. Så kan du fx følge et jordstykkes areal eller matrikelnummer over tid.

Historikken kommer fra Matriklens historiklag og hentes live. Der gennemgås højst 25 jordstykker og 60 versioner pr. jordstykke; en afkortning står altid i `afkortet`. Versionerne indeholder ikke omrids — brug `asOf` på [Hent ejendommens jordstykker](https://grundfast.dk/docs/api/matrikel-ejendom), hvis du skal tegne et tidligere omrids.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Scale-planen

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

## Parametre

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

## Eksempel

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

## Svar (200)

```json
{
  "type": "matrikel_historik",
  "bfe_nummer": 5651067,
  "jordstykker": [
    {
      "id": "1928359",
      "versioner": [
        {
          "registrering_fra": "2018-06-03T03:42:33.314Z",
          "registrering_til": null,
          "virkning_fra": "2018-06-03T03:42:33.314Z",
          "virkning_til": null,
          "id": "1928359",
          "matrikelnummer": "138o",
          "ejerlav": {
            "kode": 2006552,
            "navn": "Silkeborg Markjorder"
          },
          "areal_m2": 460,
          "kommunekode": "0740"
        },
        {
          "registrering_fra": "2009-02-03T13:47:30.000Z",
          "registrering_til": "2018-06-03T03:42:33.314Z",
          "virkning_fra": "2009-02-03T13:47:30.000Z",
          "virkning_til": "2018-06-03T03:42:33.314Z",
          "id": "1928359",
          "matrikelnummer": "138o",
          "ejerlav": {
            "kode": 2006552,
            "navn": "Silkeborg Markjorder"
          },
          "areal_m2": 462,
          "kommunekode": "0740"
        }
      ],
      "afkortet": false
    }
  ],
  "afkortet": false,
  "meta": {
    "kilde": "Datafordeler Matriklen via Grundfast",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `jordstykker[].versioner` | object[] | Jordstykkets versioner, nyeste først, hver med matrikelnummer, ejerlav, `areal_m2` og kommunekode. |
| `jordstykker[].versioner[].registrering_fra` | string \| null | Hvornår versionen blev registreret. `registrering_til` og `virkning_til` er `null` på den gældende version. |
| `jordstykker[].afkortet` | boolean | `true` når jordstykket har flere end 60 versioner; de ældste er udeladt. |
| `afkortet` | boolean | `true` når ejendommen har flere end 25 jordstykker; 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 | Historiklaget har ingen jordstykker for BFE-nummeret. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Matriklens historiklag fejlede. Historik serveres aldrig fra cache. |
| 503 | Matriklens historiklag er ikke konfigureret i dette miljø. |