Matrikel-API — jordstykker, ejerlav og BFE over Datafordeler
Matriklen er Register #2 i Grundfast og kører den samme entitets-sti som BBR: jordstykker, ejerlav og BFE-nummer i den bekvemme gamle form over Datafordelers entitetsmodel — oversat, joinet, WGS84 og current-only. Det er live nu over Matriklen2-WFS’en — demo og datakontrakt kan du teste uden nøgle. Jordstykke-geometrien er vektordata i GeoJSON, så du kan tegne dit eget matrikelkort direkte oven på dine egne kort.
GET /v1/matrikel/ejendom/:bfeHvad Matrikel-API’et giver dig
BFE-nummer som join-nøgle
Det Bestemte Faste Ejendoms-nummer er den nye nøgle, der binder Matriklen og BBR sammen. Grundfast bruger BFE som indgang — ét nummer, hele ejendommen.
Jordstykke-geometri (WGS84)
Jordstykkets afgrænsning reprojiceret fra EPSG:25832 til WGS84 og leveret som GeoJSON — geometrien bag et matrikelkort, direkte brugbar i kort uden et eget projektionslag.
Ejerlav (kode → navn)
Ejerlavet kommer gensammensat fra Matriklen med både kode og læsbart navn, så du slipper for selv at slå ejerlavskoden op.
Matrikelnummer
Matrikelnummer og tilhørende jordstykke-felter i den bekvemme gamle form — current-only, uden bitemporal støj.
Bygninger på jordstykket
Matrikelgrænsen fra Matriklen, koblet til GeoDanmarks bygningspolygoner og BBR-etager på samme BFE — så du kan tegne jordstykket med sine bygninger i 3D. Ren SVG, reprojiceret til WGS84, ét kald.
Prøv Matriklen live
Kør den nøglefrie /v1/demo/matrikel og se den endelige datakontrakt med rigtige felter — matrikelnummer, ejerlav, grundareal og oversat kommune.
Tryk Kør live for at hente et rigtigt matrikelsvar fra den nøglefrie demo — matrikelnummer, ejerlav, grundareal og oversat kommune, i den endelige datakontrakt.
Nøglefri demo: /v1/demo/matrikel svarer med et fast jordstykke-eksempel i den endelige form. Med din nøgle slår /v1/matrikel/ejendom/:bfe en rigtig ejendom op i samme form over Matriklen2-WFS’en.
Kald Matrikel-API’et i din stack
Samme kald i cURL, den typede TS-SDK og Python — slå ejendommen op på BFE-nummeret og få dens jordstykker med matrikelnummer, ejerlav og GeoJSON-geometri tilbage:
curl -H "Authorization: Bearer gf_live_…" \ https://api.grundfast.dk/v1/matrikel/ejendom/5651067
Status & datakontrakt
Endpointet er GET /v1/matrikel/ejendom/:bfe, parallelt med BBR-ejendom og med samme nøgle, auth og metering. Det svarer kun 503, hvis en deployment ikke har WFS-kilden konfigureret — demo-datakontrakten har den endelige form:
# Live nu — Register #2 (Bearer gf_live_…): GET /v1/matrikel/ejendom/5651067 → 200 { type: "samlet_fast_ejendom", bfe_nummer: 5651067, jordstykker: [{ matrikelnummer: "138o", areal_m2: 460, ejerlav: { kode, navn }, kommunekode: "0740", geometri: { type: "Polygon", coordinates: […] } }], … } # Demo-datakontrakten virker uden nøgle: GET /v1/demo/matrikel → 200 { type: "samlet_fast_ejendom", jordstykker: [ … ] }
/v1/matrikel/ejendom/:bfeBFE-nummer → jordstykker, ejerlav (kode → navn) og matrikelnummer. Klar at kalde nu.
/v1/demo/matrikelDemo-datakontrakten i den endelige form — virker uden nøgle.
Parametre
Opslaget tager ét parameter — BFE-nummeret i stien:
| Parameter | Placering | Beskrivelse |
|---|---|---|
| bfe | Sti (påkrævet) | BFE-nummeret for ejendommen, fx 5651067. Heltal — Det Bestemte Faste Ejendoms-nummer, den samme nøgle som BBR bruger. |
Felter i svaret
Svaret er en samlet fast ejendom med et array af jordstykker — hvert med matrikelnummer, areal, ejerlav og GeoJSON-geometri:
| Felt | Type | Beskrivelse |
|---|---|---|
| type | string | Ejendomstype, fx "samlet_fast_ejendom". |
| bfe_nummer | number | BFE-nummeret — join-nøglen videre til BBR og adresse. |
| jordstykker | object[] | Ejendommens jordstykker (matrikler). En samlet fast ejendom kan bestå af flere. |
| jordstykker[].matrikelnummer | string | Matrikelnummer inden for ejerlavet, fx "138o". |
| jordstykker[].areal_m2 | number | Registreret areal for jordstykket i m². |
| jordstykker[].ejerlav | { kode, navn } | Ejerlav gensammensat med både kode og læsbart navn. |
| jordstykker[].kommunekode | string | Firecifret kommunekode, fx "0740". |
| jordstykker[].geometri | GeoJSON Polygon | Jordstykkets afgrænsning i WGS84 — geometrien bag matrikelkortet, reprojiceret fra EPSG:25832. |
Grundfast vs. DAWA vs. rå Datafordeler
Hvad du får ud af boksen på matrikeldata — sandt for hver kolonne. DAWA havde jordstykker, men lukker; den rå Datafordeler har alt, men i entitetsmodel og EPSG:25832.
| Funktion | Grundfast | DAWA | Rå Datafordeler |
|---|---|---|---|
| Jordstykker gensammensat pr. ejendom (samlet fast ejendom) | Ja | delvist | flertrins |
| Oversat ejerlav (kode → navn) | Ja | Ja | Nej |
| WGS84-geometri ud af boksen | Ja | Ja | Nej |
| Current-only (ingen bitemporal støj) | Ja | Ja | Nej |
| BFE-bro til BBR, bygning & adresse | Ja | delvist | manuelt |
| SLA-cache oven på ustabil Datafordeler | Ja | Nej | Nej |
| Historik / as-of (?asOf=) ved behov | Ja | Nej | Ja |
| Lever efter DAWA-lukning (okt. 2026) | Ja | Nej | Ja |
Hvornår skal du bruge Matrikel-API’et
Matriklen er registret, du rammer, når spørgsmålet handler om jorden under ejendommen — grænser, areal og ejerlav — snarere end bygningen ovenpå. Tre typiske tilfælde:
Tegn et matrikelkort
Hvert jordstykke kommer som en GeoJSON-polygon i WGS84 — geometrien bag et matrikelkort — så du lægger matrikelgrænserne direkte i Leaflet, MapLibre eller Mapbox. Vil du have bygningernes aftryk med, henter du dem fra Bygningspolygoner-API’et på samme BFE.
Slå ejerlav op
Ejerlavet leveres gensammensat med både kode og læsbart navn på hvert jordstykke, så du slipper for et separat opslag. Har du brug for hele registret, se Ejerlavskoder.
Areal pr. BFE
Summér jordstykkernes areal_m2 pr. BFE-nummer for at få grundarealet. Skal du se, hvordan matriklen så ud på en tidligere dato, giver Historik-API’et samme svar med ?asOf=.
Kom i gang med Matriklen
Opret en gf_live_-nøgle i dashboardet og kald /v1/matrikel/ejendom/:bfe. Spørgsmål om jordstykke-/ejerlav-dækning? Skriv til os.
Se også
Ofte stillede spørgsmål
Er Matrikel-API’et live nu?
Ja. GET /v1/matrikel/ejendom/:bfe er live som Register #2 — kørt over Matriklen2-WFS’en og verificeret mod BFE 5651067 (matrikelnummer 138o). BBR er Register #1. Demo (/v1/demo/matrikel) virker uden nøgle. Endpointet svarer kun 503, hvis en given deployment ikke har WFS-kilden konfigureret.
Hvad dækker Matriklen i Grundfast?
Jordstykker, ejerlav (kode → navn), matrikelnummer og BFE-nummer som join-nøgle — den bekvemme gamle form over Datafordelers entitetsmodel. Det er en property-/parcel-record; ejer hænger som enrichment på ejendommen, ikke som et selvstændigt opslag.
Kan jeg tegne et matrikelkort med API’et?
Ja — men vær opmærksom på, at du får vektorgeometri, ikke et færdigrenderet kortbillede. Hvert jordstykke returneres som en polygon i GeoJSON (WGS84), altså den matrikeldata og geometri, der ligger bag et matrikelkort. Du tegner selv laget i fx Leaflet, MapLibre eller Mapbox oven på dit eget baggrundskort. Vi leverer ingen raster-kortfliser.
Hvordan tilgår jeg Matriklen?
Med en gf_live_-nøgle mod GET /v1/matrikel/ejendom/:bfe — samme nøgle, auth og metering som BBR. Uden nøgle kan du teste den endelige datakontrakt på /v1/demo/matrikel.
Hvad koster Matrikel-opslag?
Matriklen kører på den fælles selvbetjente prismodel (Free / Starter / Pro / Scale) med samme nøgle og metering som BBR, DAGI og adresser. Se priser for kald-inkluderet og overforbrug.
Er Grundfast officielt / tilknyttet SDFI?
Nej. Grundfast er et uafhængigt compatibility-lag — uofficielt, men det virker. Data kommer fra Datafordeler / SDFI (CC BY 4.0); vi krediterer kilden.
Matriklen — hvert jordstykke i landet
Matrikulære jordstykker for hele landet med ejerlavsnavn og areal, koblet til BFE så matrikel, bygninger og adresse hænger sammen. Kortet viser vores dækning kommune for kommune.
- Adresser
- 2.700.904
- Jordstykker
- 2.565.631
- Kommuner
- 98