Spring til indhold

Grundfast
Matriklen (ejerlav)

Ejerlav-API: fra ejerlavskode til ejendom

Slå en ejerlavskode op og få navnet, find koden ud fra et navn, og brug koden sammen med et matrikelnummer til at finde jordstykket og BFE-nummeret. Registret ligger i Grundfast selv, så opslagene svarer, også når Datafordeler ikke gør.

Opret gratis kontoSe dokumentationen

Kaldene

GET/v1/ejerlav/autocomplete
rigtigt svar

Ejerlavsnavn eller kode

køge jorder
  • Lellinge, Køge Jorder2000256
  • Sdr. Køge, Køge Jorder2000254
  • Ny Lellingegård, Køge Jorder2000257
  • Gl. Lellingegård, Køge Jorder2000255
  • Gl. Køgegård Hgd., Køge Jorder2000253

5 forslag af 9.033 ejerlav · kode-præfiks eller navn

Svaret er kørt mod registret og står i fuld længde nedenfor. Uden nøgle viser /v1/demo/ejerlav svarformatet; med en gratis nøgle får du op til 20 forslag pr. kald.

Hvad du får

Kode og navn, begge veje

Et ejerlav er det område, et matrikelnummer hører til. Koden er et tal, navnet er det, folk skriver — API’et oversætter begge veje.

  1. Kode → navn

    /v1/ejerlav/2000254 giver “Sdr. Køge, Køge Jorder”. En kode, registret ikke kender, giver 404 — aldrig et gættet navn.

  2. Navn → kode

    Autocomplete matcher begyndelsen af koden eller en del af navnet og giver op til 20 forslag — til et felt, hvor brugeren kender navnet, men ikke koden.

  3. Alle 9.033 ejerlav

    Hele registret side for side, eller som gratis CSV og JSON på Ejerlavskoder.

  4. Svarer, når Datafordeler ikke gør

    Registret ligger hos os, så et opslag afhænger ikke af, at Datafordeler svarer i det øjeblik.

GET /v1/ejerlav/autocomplete?q=køge jorderjson
{
  "antal": 5,
  "total": 9033,
  "ejerlav": [
    { "kode": 2000256, "navn": "Lellinge, Køge Jorder" },
    { "kode": 2000254, "navn": "Sdr. Køge, Køge Jorder" },
    { "kode": 2000257, "navn": "Ny Lellingegård, Køge Jorder" },
    { "kode": 2000255, "navn": "Gl. Lellingegård, Køge Jorder" },
    { "kode": 2000253, "navn": "Gl. Køgegård Hgd., Køge Jorder" }
  ],
  "meta": { "kilde": "Datafordeler Matriklen (ejerlav) via Grundfast" }
}

Kæden

Fra ejerlav til jordstykke og BFE

En matrikel skrives som matrikelnummer plus ejerlav. Det par udpeger ét jordstykke, og jordstykket hører til en ejendom med et BFE-nummer. Derfra er BBR, vurdering og byggelinjer ét kald væk.

  1. 1EjerlavskodeSdr. Køge, Køge Jorder2000254
  2. 2MatrikelnummerNummeret inden for ejerlavet2bu
  3. 3Jordstykke og ejendomGeometri i WGS84 og BFE-nummerBFE 5301334
jordstykke.shbash
# Ejerlav + matrikelnummer → jordstykket og dets BFE-nummer:
curl "https://api.grundfast.dk/v1/jordstykker?ejerlavkode=2000254&matrikelnr=2bu" \
  -H "Authorization: Bearer gf_live_…"

# → "ejerlavsnavn": "Sdr. Køge, Køge Jorder", "matrikelnummer": "2bu",
#   "bfe_nummer": 5301334, … og jordstykkets geometri i WGS84

Kald det

Tre endpoints og et fjerde til jordstykket

Samme nøgle, samme fejlformat og samme svarform som resten af API’et. Listen sider med per_side og side, så hele registret kan hentes i ét gennemløb.

curl "https://api.grundfast.dk/v1/ejerlav/autocomplete?q=k%C3%B8ge%20jorder" \
  -H "Authorization: Bearer gf_live_…"
GET /v1/ejerlav?per_side=6json
{
  "antal": 6,
  "total": 9033,
  "ejerlav": [
    { "kode": 10051, "navn": "Frederiksberg" },
    { "kode": 10151, "navn": "Gentofte" },
    { "kode": 10251, "navn": "Buddinge" },
    { "kode": 10252, "navn": "Gladsaxe" },
    { "kode": 10352, "navn": "Hellerup" },
    { "kode": 10451, "navn": "Herlev" }
  ],
  "meta": { "kilde": "Datafordeler Matriklen (ejerlav) via Grundfast" }
}
GET/v1/ejerlav/:kode

Ejerlavskode → navn. Ukendt kode giver 404.

GET/v1/ejerlav/autocomplete?q=

Op til 20 forslag på kode-præfiks eller navn.

GET/v1/ejerlav

Hele registret sidevis med per_side (højst 100) og side.

GET/v1/jordstykker?ejerlavkode=&matrikelnr=

Jordstykket med BFE-nummer og geometri.

Spørgsmål

Ofte stillede spørgsmål

GET /v1/ejerlav/:kode giver navnet, fx /v1/ejerlav/2000254 → Sdr. Køge, Køge Jorder. En kode, registret ikke kender, giver 404, aldrig et gættet navn. Den anden vej, fra navn til kode, går GET /v1/ejerlav/autocomplete?q=.

Ejerlavskode og matrikelnummer udpeger ét jordstykke. GET /v1/jordstykker?ejerlavkode=&matrikelnr= giver jordstykket med BFE-nummer og geometri, og med BFE-nummeret henter du BBR, vurdering og resten af ejendommen.

Ja. GET /v1/ejerlav lister alle 9.033 ejerlav med per_side (højst 100) og side. Skal du bare bruge listen én gang, kan den hentes gratis som CSV eller JSON på siden Ejerlavskoder.

GET /v1/demo/ejerlav svarer uden nøgle med et fast udsnit af registret, så du kan se svarformatet. Opslag, autocomplete og hele listen kræver en gratis gf_live_- eller gf_test_-nøgle.

Ja, kode og navn i samme form, så du kan skifte base-URL og nøgle og beholde din parsing. Registret ligger i Grundfast selv, så opslagene svarer, også når Datafordeler ikke gør.

Se også

Begreber og guides

Ejerlav-API

Ejerlavet er vejen ind til matriklen

Opret en gratis konto, lav en API-nøgle, og gå fra ejerlav og matrikelnummer til jordstykket, BFE-nummeret og resten af ejendommen.
Opret gratis kontoSe dokumentationen

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0