Spring til indhold

Grundfast

Versionshistorik for jordstykker

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

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

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, hvis du skal tegne et tidligere omrids.

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 versioner svaret indeholder.

Eksempel

curl "https://api.grundfast.dk/v1/matrikel/ejendom/5651067/historik" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
Svar · eksempel200
{
  "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"
  }
}

Parametre

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

Felter i svaret

jordstykker[].versionerobject[]
Jordstykkets versioner, nyeste først, hver med matrikelnummer, ejerlav, areal_m2 og kommunekode.
jordstykker[].versioner[].registrering_frastring | null
Hvornår versionen blev registreret. registrering_til og virkning_til er null på den gældende version.
jordstykker[].afkortetboolean
true når jordstykket har flere end 60 versioner; de ældste er udeladt.
afkortetboolean
true når ejendommen har flere end 25 jordstykker; 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.
404Historiklaget har ingen jordstykker for BFE-nummeret.
429Burst-grænsen eller månedskvoten er nået. Se Retry-After.
502Matriklens historiklag fejlede. Historik serveres aldrig fra cache.
503Matriklens historiklag 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/matrikel/ejendom/5651067/historik

Bruges ofte sammen med

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