DatafordelerenMatriklen2 REST # Matriklen REST efter 15. januar 2027: samme sti, ny vært Datafordelerens Matriklen2 REST-tjeneste lukker den **15. januar 2027**. Grundfast svarer på de samme stier i begge versioner, med de samme parametre og den samme JSON eller XML, hentet fra Datafordelerens GraphQL. Integrationen skifter kun vært og nøgle. [Datafordelerens REST lukker om 80 dage · 15. januar 2027](https://grundfast.dk/datafordeler-rest-lukker) ## Før og efter Erstat `https://services.datafordeler.dk` med `https://api.grundfast.dk/datafordeler`, og læg en Grundfast-nøgle i `password=`. ``` # Før — lukker 15. januar 2027 curl 'https://services.datafordeler.dk/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom?Format=JSON&SFEBFEnr=5651067&username=TJENESTEBRUGER&password=…' # Efter — samme sti, samme parametre, samme JSON. Kun værten og nøglen skifter. curl 'https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom?Format=JSON&SFEBFEnr=5651067&password=gf_live_…' ``` ## Metoderne Seks metoder i version 2.0.0 og de samme under `/Matriklen2/Matrikel/1.0.0/rest/`, hvor MatrikulaerSag som før er uden listen over sagsoperationer. Parameternavne matches uden hensyn til store og små bogstaver, som i REST; værdierne ikke, bortset fra Ejendomstype og Kommunenavn. - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/SamletFastEjendom` - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/BygningPaaFremmedGrund` - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/Ejerlejlighed` - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/BestemtFastEjendom` - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/MatrikelKommune` - `/datafordeler/Matriklen2/Matrikel/2.0.0/rest/MatrikulaerSag` ### Parametre pr. metode SamletFastEjendom SFEBFEnr · Ejerlavskode + Matrikelnr · Point · JordstykkeId · SagsId Registreringstid · Virkningstid · Status BygningPaaFremmedGrund SFEBFEnr · BPFGBFEnr · Ejerlavskode + Matrikelnr · Point · SagsId Registreringstid · Virkningstid · Status Ejerlejlighed SFEBFEnr · BPFGBFEnr · ELBFEnr · Ejerlavskode + Matrikelnr (+ Ejerlejlighednr) · SagsId Registreringstid · Virkningstid · Status BestemtFastEjendom BFEnr (flere med |) · SagsId · Ejendomstype Registreringstid · Virkningstid · Status MatrikelKommune Kommunekode · Kommunenavn Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til MatrikulaerSag SagsId · Journalnr · Sagskategori · Kommunenavn Registreringstid · Virkningstid · Status · RegistreringstidFra/Til · VirkningstidFra/Til Som i REST tager kun `BFEnr` på BestemtFastEjendom flere værdier (adskilt med `|`). Der er ingen sider: `page`, `pagesize` og `count` giver REST’s egen 400, og hele svaret er én FeatureCollection. `Format=XML` giver XML, alt andet JSON. Uden et identificerende parameter er svaret tomt — aldrig hele registret. ## Nøglen - `password=` i URL’en — det sted, hvor tjenestebrugerens adgangskode stod. `username=` ignoreres og kan blive stående. - `apiKey=` eller `token=` i URL’en. - Headeren `Authorization: Bearer …` eller `X-API-Key`. Nøglen skrives aldrig i Grundfasts logs. Stien er med på alle planer, også den gratis, og et kald er én enhed i den almindelige kvote. En nøgle med begrænset adgang skal have Matriklen med. ``` # Nøglen kan også sendes som header, og version 1.0.0 svarer også curl -H 'Authorization: Bearer gf_live_…' \ 'https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/1.0.0/rest/BestemtFastEjendom?BFEnr=5651067|426091' ``` ## Hvor tæt på REST? Svarene er sammenlignet med den levende REST-tjeneste, hentet samme øjeblik fra REST og GraphQL: 68 optagne sager på tværs af alle seks metoder og begge versioner, med XML-svar, fejlsvar og tomme svar. I hver sag var hvert objekt identisk, med samme feltrækkefølge, når listernes rækkefølge ses bort fra. Dertil 90 af 90 tilfældige stikprøver og det bredeste opslag, REST tillod — 1 075 af 1 075 sager identiske. Herunder står alle kendte forskelle. Finder I en, der ikke står her, er det en fejl — skriv til [hej@grundfast.dk](mailto:hej@grundfast.dk?subject=Matriklen%20REST-afvigelse). ### Data Værdier eller former i svaret, der ikke er som i REST. - #### Et interval med flere versioner af samme sag besvares MatrikulaerSag Ramte RegistreringstidFra/Til (eller VirkningstidFra/Til) flere versioner af samme sag, svarede REST "(500) Internal server error". Her returneres versionerne. Kilde: Live-prøve 2026-10-27: SagsId=100240508&RegistreringstidFra=2026-01-01&RegistreringstidTil=2026-10-01. - #### Interval på begge tidsakser: navn og journalnummer slås op i dag MatrikelKommune MatrikulaerSag Med interval på både registrering og virkning findes objekterne via deres id: Kommunekode og SagsId direkte, men Kommunenavn, Journalnr og Sagskategori slås op på det angivne (eller nuværende) tidspunkt først. En kommune eller sag der ikke findes på det tidspunkt, findes derfor kun via sin kode eller sit id. Gør sådan: Brug Kommunekode eller SagsId sammen med to intervaller. Kilde: Følger af MAT/v3: uden tidspunkt-argumenter skal der filtreres på id_lokalId. ### Parametre Parametre, REST tog imod, men som her afvises med 400 og parameterens navn — aldrig stiltiende ignoreret. - #### Sagsoperation og RekvirentRef afvises med 400 MatrikulaerSag REST genkendte de to parametre, men matchede dem ikke forudsigeligt: RekvirentRef=20265088 gav intet svar, selvom sag 100240508 har netop den rekvirentRef. I stedet for at gætte REST’s regel afvises de med en 400, der navngiver parameteren. Gør sådan: Slå sagen op med SagsId eller Journalnr. Kilde: Live-prøve 2026-10-27 (SagsId=100240508 → rekvirentRef 20265088; RekvirentRef=20265088 → 0 sager). ### Sider og grænser Sidestørrelse, rækkefølge og de lofter, GraphQL-kilden sætter. - #### Rækkefølgen i lister er fast her, tilfældig i REST REST svarede objekter og indlejrede lister (jordstykker, centroider, ejerlejligheder, bygninger på fremmed grund, sagsoperationer, bestemtFastEjendom) i en rækkefølge der kunne skifte mellem to ens kald. Her sorteres efter id_lokalId, så registreringFra, så status. Indholdet er det samme, dubletter i sagsoperationer bevares. Gør sådan: Sortér selv, hvis rækkefølgen betyder noget. Kilde: Paritetsfixtures: alle 68 sager er identiske som multimængder; rækkefølgen afveg i flere. - #### Højst 5 000 objekter i ét svar REST havde ingen paging og ingen øvre grænse. Her afvises et kald, der rammer mere end 5 000 objekter på øverste niveau, med en 400. Det bredeste opslag REST tillod i prøverne (en sagskategori i en kommune) gav 1 075 sager og besvares fuldt. Gør sådan: Del opslaget op (fx per kommune eller sag). Kilde: Live-prøve 2026-10-27: Sagskategori=Matrikulær sag&Kommunenavn=Billund Kommune, 1 075/1 075 identiske. ### Nøgle, format og fejl Det, der ligger uden om selve dataene. - #### Forslaget i "Did you mean" kan være et andet Et ukendt parameternavn giver samme 400-tekst som REST ("(400) Parameter: x unrecognized."), men det foreslåede navn vælges efter redigeringsafstand og er ikke altid det REST foreslog (REST foreslog fx "page" for "kommunekode"). Kilde: Live-prøve 2026-10-27. - #### Et ugyldigt Point giver 400, ikke 500 SamletFastEjendom BygningPaaFremmedGrund Point skal være WKT: POINT(x y) i EPSG:25832, mellemrummet URL-kodet. REST svarede en anden form (fx "x y") med "(500) Internal server error"; her er det en 400 med eksempel på formen. Kilde: Live-prøve 2026-10-27. - #### Nedbrud hos Datafordeleren er JSON Parameterfejl er REST’s egne tekstsvar (text/plain). Svarer Datafordelerens GraphQL ikke, gives 502/503 med JSON {"error": …} som i resten af API’et, hvor REST gav en tekst. Kilde: Controllerens fejlgren. Vil I hellere have ejendommens jordstykker samlet på BFE med geometri i WGS84, er [/v1/matrikel](https://grundfast.dk/docs/api) Grundfasts egen form. Begge kan bruges med den samme nøgle. ## Ofte stillede spørgsmål ### Skal jeg ændre min kode for at bruge Grundfasts Matriklen REST-sti? Kun værten og nøglen. https://services.datafordeler.dk/Matriklen2/Matrikel/2.0.0/rest/… bliver til https://api.grundfast.dk/datafordeler/Matriklen2/Matrikel/2.0.0/rest/…, og password= får en Grundfast-nøgle i stedet for tjenestebrugerens adgangskode (username ignoreres). Stier, parametre, FeatureCollection, feltnavne og XML er de samme; de kendte afvigelser står på siden. ### Hvilke versioner og metoder findes? Version 1.0.0 og 2.0.0, begge med SamletFastEjendom, BygningPaaFremmedGrund, Ejerlejlighed, BestemtFastEjendom, MatrikelKommune, MatrikulaerSag. Som i den gamle tjeneste har MatrikulaerSag kun listen over sagsoperationer i version 2.0.0. ### Hvad koster det? Stien er med på alle planer, også den gratis. Et kald er én enhed i den almindelige kvote, uanset hvor mange objekter svaret har — der er ingen særskilt pris pr. register. ### Er svaret det samme som fra Datafordelerens REST-tjeneste? Ja, inden for de kendte afvigelser. I 68 optagne sager på tværs af alle metoder og begge versioner var hvert objekt identisk med REST-svaret, når listernes rækkefølge ses bort fra — også i XML. 90 tilfældige stikprøver mod den levende tjeneste og det bredeste opslag, den tillod (1 075 sager), var også identiske. ### Hvor kommer dataene fra? Fra Datafordelerens moderniserede GraphQL-tjeneste for Matriklen, hentet live ved hvert kald og skrevet om til REST-formen. Grundfast er ikke tilknyttet Klimadatastyrelsen. ## Skift værten før 15. januar Opret en gratis nøgle, sæt den i `password=`, og kør jeres eksisterende Matriklen-kald mod `api.grundfast.dk/datafordeler`. [Kom i gang gratis](https://grundfast.dk/dashboard?mode=register) [Hvad der ellers lukker](https://grundfast.dk/datafordeler-rest-lukker) Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0 Se også - [Datafordeler-REST lukker Hvad der lukker 15. januar 2027](https://grundfast.dk/datafordeler-rest-lukker) - [EBR REST på samme sti Ejendomsbeliggenhed — skift kun værten](https://grundfast.dk/datafordeler-ebr-rest) - [BBR REST på samme sti BBRPublic — skift kun værten](https://grundfast.dk/datafordeler-bbr-rest) - [Migreringsguide 2026 Tidslinje og trin for trin](https://grundfast.dk/migrering) Begreber og guides - [Datafordeler](https://grundfast.dk/begreber/datafordeler) - [Matriklen](https://grundfast.dk/begreber/matriklen) - [Samlet fast ejendom](https://grundfast.dk/begreber/samlet-fast-ejendom) - [Hvordan klarer vi os med færre kald?](https://grundfast.dk/guides/spar-paa-kald)