Sådan migrerer du til Tinglysning REST API før 6. november

Af Kenneth Christensen · 20. september 2026.

Tinglysningsretten lukker de to gamle base-URL'er den 6. november 2026. Bruger din integration stadig https://tinglysning.dk/tinglysning/ssl/ eller https://tinglysning.dk/tinglysning/unsecuressl/, holder den op med at virke på dagen. [2]

1. Kontrollér systembrugeradgangen

Et skift af base-URL er ikke nok, hvis du hidtil har brugt det gamle HTTP API med et OCES-certifikat alene. REST API kræver et OCES3-systemcertifikat og en registreret systembruger. Produktionsadgang kræver desuden storkunderegistrering hos Skatteforvaltningen, og ansøgningen skal angive de IP-adresser, der skal have adgang. [2] [3]

Læs først de nye adgangskrav fra 6. november, hvis registreringen ikke er på plads.

Varslingen nedenfor er sendt til en registreret kontaktperson for en virksomhed med systemadgang. Bruger du alene certifikatadgangen til det gamle HTTP API, kan du have overset den.

2. Find den opdaterede dokumentation

Gå til Tinglysningsretten → Professionelle brugere → eTl. Her ligger både Guide til systemadgang og S2S REST API Dokumentation 1.0, som er de to dokumenter, du skal bruge til migreringen. [1]

Denne guide gælder forespørgsler mod tingbogen. Skal du også anmelde, er det fortsat HTTP XML API, der skal bruges. [3]

3. Skift base-URL'en

Tinglysningsrettens REST-dokumentation beskriver Release 55 som skæringsdatoen, hvor de to gamle base-URL'er udfases. Endpointstierne bevares, mens base-URL'en flytter til https://rest-api.tinglysning.dk/. [2]

Et adresseopslag går eksempelvis fra:

https://tinglysning.dk/tinglysning/ssl/ejendom/adresse?postnummer=4040&vejnavn=Venusvej&husnummer=1&by=Jyllinge

til:

https://rest-api.tinglysning.dk/ejendom/adresse?postnummer=4040&vejnavn=Venusvej&husnummer=1&by=Jyllinge

Det samme gælder blandt andet ejendom/hovednoteringsnummer, ejdsummarisk/{uuid}, tinglysningsobjekter/senesteaendring og tinglysningsobjekter/aendringer. [2]

Find alle berørte kald

Søg i integrationens konfiguration og den kode, der sender kald til Tinglysning, efter tinglysning.dk/tinglysning/ssl og unsecuressl, og erstat hele den gamle base-URL med https://rest-api.tinglysning.dk/. Præfikserne /tinglysning/ssl/ og /tinglysning/unsecuressl/ skal ikke med over.

4. Test mod REST-miljøet før produktion

Tinglysningsrettens fællestestmiljø for REST API ligger på https://test-rest-api.tinglysning.dk. Hotfixmiljøet ligger på https://dss-rest-api.tinglysning.dk. [3]

Brug et testcertifikat og en systembrugeradgang, der er oprettet til testmiljøet. Tinglysningsrettens vejledning beskriver en særskilt ansøgning til testmiljøerne; et produktionscertifikat alene er ikke tilstrækkelig testopsætning. [3]

Et enkelt adresseopslag kan se sådan ud:

curl --cert ./oces.pem --http1.1 \
  "https://test-rest-api.tinglysning.dk/ejendom/adresse?postnummer=4040&vejnavn=Venusvej&husnummer=1&by=Jyllinge"

5. Sæt ændringen i produktion og hold øje med de rigtige fejl

Efter en succesfuld test skal produktion kun pege på https://rest-api.tinglysning.dk. Log HTTP-status og et sikkert korrelations-id.

REST-dokumentationen angiver 401 Unauthorized, hvis certifikatet mangler eller er ugyldigt, eller virksomheden ikke er registreret som systembruger. Kontrollér derfor både certifikat og registrering, før du forsøger kaldet igen. [2]

En fejl i JSON- eller XML-deserialisering peger på et kontraktproblem og bør undersøges med et anonymiseret testsvar. Lad en behandlet fejl følge jeres normale backoff-regler; undgå ukontrollerede, samtidige gentagelser mod tingbogen.

Har du brug for data frem for en direkte integration?

Råd til Boligs API til tinglysningsdata samler ejendomsdata, tinglyste lån, boligvurderinger og finansielle beregninger.

Læs også, hvordan vi strukturerer tinglysningsdata i vores boligdata-API, og hvilke begrænsninger der gælder for tinglyst hovedstol og aktuel restgæld.

Kilder

[1]: https://domstoldk.euwest01.umbraco.io/tinglysningsretten/professionelle-brugere/etl/ Tinglysningsretten: eTl, REST API-dokumentation, aflæst 20. september 2026

[2]: https://domstoldk.euwest01.umbraco.io/media/aowf4zkh/s2s-rest-api-dokumentation-10.zip Tinglysningsretten: S2S REST API Dokumentation 1.0, 12. juni 2026

[3]: https://domstoldk.euwest01.umbraco.io/media/atlfaq0u/guide-til-systemadgang.docx Tinglysningsretten: Guide til systemadgang, version 1.7 af 2. marts 2026