Ejerlav-API til danske ejerlavskoder
Grundfast genudstiller Matriklens ejerlav som et DAWA-kompatibelt drop-in: slå et ejerlav op på dets kode, list hele registret, eller autocomplete på ejerlavsnavn — alt over /v1/ejerlav. Ejerlavskoden er den ene halvdel af en dansk matrikelbetegnelse (ejerlavskode + matrikelnr), så det her kobler direkte til jordstykke, BFE og ejendom. Live nu; prøv den nøglefrie demo, eller kald det med din egen nøgle.
GET /v1/ejerlavHvad ejerlav-API’et giver dig
Ejerlav på kode
Slå et ejerlav op på dets kode med GET /v1/ejerlav/:kode og få det læsbare ejerlavsnavn tilbage — fx kode 10051 → “Frederiksberg”. Ejerlavskoden er den ene halvdel af en dansk matrikelbetegnelse, klar at vise i din UI i stedet for et råt tal.
Autocomplete på navn
GET /v1/ejerlav/autocomplete?q= laver typeahead over ejerlavsnavnet, så en bruger kan taste “vejle” og få ejerlavskoderne tilbage. Perfekt bag et adresse- eller matrikel-søgefelt, hvor koden skal med videre.
Hele registret
GET /v1/ejerlav lister hele ejerlavs-registret (godt 9.000 rækker), pagineret med per_side og side. Svaret bærer både antal og total, så du kan paginere og cache et lokalt opslagskort én gang.
Kobler til matrikel & BFE
Ejerlavskode + matrikelnr identificerer et jordstykke entydigt. Kombinér ejerlav-opslaget med reverse geocoding og Matrikel-API’et for at gå hele vejen fra koordinat eller adresse → jordstykke → BFE → ejendom.
Status & datakontrakt
Endpointet er GET /v1/ejerlav med en gf_live_-nøgle — samme auth og metering som de øvrige registre. List og autocomplete deler den samme EjerlavList-form.
Kald ejerlav-API’et i din stack
Slå op på ejerlavsnavn i cURL, TypeScript og Python — typeahead over GET /v1/ejerlav/autocomplete med q. Skal du hele registret, lister GET /v1/ejerlav det pagineret med per_side og side:
curl -H "Authorization: Bearer gf_live_…" \ "https://api.grundfast.dk/v1/ejerlav/autocomplete?q=vejle"
…og svaret, i EjerlavList-formen med antal og total:
# DAWA-ejerlav drop-in, Bearer gf_live_…: GET /v1/ejerlav/autocomplete?q=vejle → 200 { antal: 2, total: 9033, ejerlav: [ { kode: 1181652, navn: "Vejle Bygrunde" }, { kode: 1181653, navn: "Nørremarken, Vejle Jorder" } ], meta: { kilde: "Datafordeler Matriklen (ejerlav) via Grundfast", grundfast_version: "0.1.0" } }
/v1/ejerlavList hele registret, pagineret med per_side og side. Live nu.
/v1/ejerlav/:kodeEjerlavskode → { kode, navn, meta }. Ét opslag, klar at kalde.
/v1/ejerlav/autocompleteTypeahead over ejerlavsnavnet — samme EjerlavList-shape.
/v1/demo/ejerlavNøglefri demo — prøv datakontrakten allerede nu, uden nøgle.
Ejerlavskoder
En ejerlavskode er et fircifret eller længere nummer, der navngiver et ejerlav — den ene halvdel af matrikelbetegnelsen sammen med matrikelnr. Registret rummer godt 9.000 ejerlav; her er nogle få eksempler på kode → navn:
| Ejerlavskode | Ejerlavsnavn |
|---|---|
| 10051 | Frederiksberg |
| 10151 | Gentofte |
| 10251 | Buddinge |
| 10252 | Gladsaxe |
| 10352 | Hellerup |
| 10451 | Herlev |
Se alle ejerlavskoder — hele registret som en søgbar reference-tabel.
Kom i gang med ejerlavsdata
Opret en gratis nøgle og prøv /v1/demo/ejerlav nu — så er du klar til /v1/ejerlav, der allerede er live. Skal du oversætte en hel bunke ejerlavskoder til navne? Skriv til os.
Se også reverse geocoding & BFE, Matrikel-API og vejnavne.
Ofte stillede spørgsmål
Hvad er et ejerlav / en ejerlavskode?
Et ejerlav er en geografisk-historisk inddeling af Danmark, der bruges i matriklen. Sammen med et matrikelnummer udgør ejerlavskoden en entydig matrikelbetegnelse (fx ejerlavskode 1181652 + matrikelnr 4a). Grundfast slår ejerlavskode ↔ ejerlavsnavn op, så du kan vise navnet i stedet for koden.
Hvordan slår jeg en ejerlavskode op?
Kald GET /v1/ejerlav/:kode med ejerlavskoden — fx /v1/ejerlav/1181652 — og få { kode, navn, meta } tilbage med det læsbare ejerlavsnavn. Skal du den anden vej, laver GET /v1/ejerlav/autocomplete?q= typeahead over ejerlavsnavnet og giver ejerlavskoden med retur. Begge er live og deler den samme EjerlavList-shape.
Hvordan finder jeg ejerlavskoden ud fra en adresse eller et koordinat?
Ejerlavskoden bor i matrikelbetegnelsen sammen med matrikelnr, som identificerer et jordstykke entydigt. Brug reverse geocoding eller adresse-opslaget til at nå jordstykket, der bærer både ejerlavskode og matrikelnr — og slå så det læsbare ejerlavsnavn op med GET /v1/ejerlav/:kode. Sådan går du fra koordinat eller adresse hele vejen til ejerlav, jordstykke og BFE.
Er ejerlav-API’et live?
Ja. GET /v1/ejerlav, GET /v1/ejerlav/:kode og GET /v1/ejerlav/autocomplete er live i produktion og kræver en gf_live_-nøgle (401 uden). Den nøglefrie demo GET /v1/demo/ejerlav svarer 200, så du kan prøve datakontrakten uden nøgle.
Er det DAWA-kompatibelt?
Ja — det er et drop-in over DAWA’s ejerlav-flade, serveret fra Matriklen via Datafordeler. Samme kode/navn-form, så du kan skifte host uden at omskrive dine opslag, og den samme EjerlavList-shape går igen på både list og autocomplete.
Hvor mange ejerlav findes der, og hvor kommer data fra?
Registret dækker hele Danmark (godt 9.000 ejerlav). Kilden er Datafordeler / Matriklen (SDFI), CC BY 4.0 — Grundfast leverer transformen, stabiliteten og SLA’en oven på en cachet mirror, ikke selve grunddataene.
Hvordan kobler ejerlav til matrikel og BFE?
Ejerlavskoden plus matrikelnr identificerer et jordstykke. Kombinér ejerlav-opslaget med reverse geocoding og Matrikel-API’et for at gå fra koordinat eller adresse → jordstykke → BFE → ejendom i ét flow.