Siden beskriver fildownload, der udstilles på Datafordeleren fra Ejerfortegnelsen (EJF).

Få en introduktion til Fildownload på Datafordeleren, hvis du har brug for en generel og mere teknisk indføring i fildownload på Datafordeleren.

Læs mere om Anmodning om adgang til beskyttede registerdata.

Ønsker du at opsætte et kopiregister, kan du med fordel benytte Kopiregisterguide (fildownload).


Sideinformation

Bemærk

Der er kun adgang til de fortrolige entiteter for offentlige myndigheder.

Bemærk

Du skal bruge OAuth (Shared Secret eller Certifikat), samt være godkendt af registret for at se og hente data fra EJF.





Entitetsbaserede fildownload


Generelt for EJF fildownload 


Formater

JSON, CSV

Bitemporal filtrering

Current, Temporal og Bitemporal.

Læs mere om EJF's bitemporalitet.

Nyeste version af fildownload

1

Sikkerhedszone

5 –  Indeholder fortrolige eller følsomme data

TværgåendeNej
Dato- og tidsformat

Datoformat følger ISO 8601 Date and time format.

Alle datoer skrives med andre ord i formatet yyyy-mm-ddTHH:MM:SS.ssssss, hvor tidsangivelsen kan udelades.

UTC kan angives enten ved +HH:MM (2019-07-05T07:50:14.687580+01:00) eller ved at benytte Z (2019-07-05T07:50:14.687580Z)

Udstillede entiteter

EJF udstiller alle deres entiteter i alle typer af download.

Registret har følgende entiteter:

  • AlternativAdresse
  • Ejendomsadministrator
  • Ejerskab
  • Ejerskabsskifte
  • Ejerskifte
  • Handelsoplysninger
  • PersonEllerVirksomhedsadministrator
  • PersonVirksomhedsoplysninger

Se felter for entiteterne i registrets bilag for opdatering (.XSD)

Læs mere om registrets entiteter i objekttypekataloget




Generelle url'er for EJF

Se tilgængelig fildownload for EJF:

https://api.datafordeler.dk/FileDownloads/GetAvailableFileDownloads?Register=EJF

Hent tilgængelige totaldownload for alle entiteter i EJF:

https://api.datafordeler.dk/FileDownloads/GetFile?Register=EJF






Totaldownload bitemporal

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret med fuld bitemporalitet. Læs mere om EJF's bitemporalitet.

Generelt

Navn i Dataoversigten

Ejerfortegnelsen Fildownload

Genereringstid

Natten til mandag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

OAuth Shared Secret eller OAuth Certifikat.

Udstillede entiteter

Alle






Totaldownload temporal

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret kun med virkningsdimensionen. Læs mere om EJF's bitemporalitet.

Generelt

Navn i Dataoversigten

Ejerfortegnelsen Fildownload

Genereringstid

Natten til mandag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

OAuth Shared Secret eller OAuth Certifikat.

Udstillede entiteter

Alle






Totaldownload aktuel

Beskrivelse

Et totaldownload af et eller alle entiteter fra registret kun med aktuelle data. Læs mere om EJF's bitemporalitet.

Generelt

Navn i Dataoversigten

Ejerfortegnelsen Fildownload

Genereringstid

Natten til mandag, mellem klokken 3 og 6

Arkiveringstid

7 dage

Type

Totaldownload

Adgangsniveau

OAuth Shared Secret eller OAuth Certifikat.

Udstillede entiteter

Alle






Deltadownload

Beskrivelse

Et deltadownload af et eller alle entiteter fra registret med bitemporalitet. Læs mere om EJF's bitemporalitet.

Deltadownload kan kun hentes ved bruge af parameteren Filename i metoden GetFile.

Hvis du vedligeholder en kopi af registret ved hjælp af deltadownload, anbefales det at udgangspunktet er et totaldownload bitemporal. 

Generelt

Navn i Dataoversigten

Ejerfortegnelsen Fildownload

Genereringstid

Dagligt mellem klokken 3 og 6

Arkiveringstid

14 dage

Type

Deltadownload

Adgangsniveau

OAuth Shared Secret eller OAuth Certifikat.

Udstillede entiteter

Alle





Sammenstillede fildownload

Der er udviklet specielle sammenstillede fildownload som sammensætter data på tværs af register-tabeller. Disse fildownload er implementeret for EJF, hvor EJF-data sammenstilles med CPR, for at anvendere med nødvendig hjemmel til denne data ikke behøver hente alt deres data via GraphQL-tjenesterne.

Bemærk

Sammenstillede fildownload for EJF bliver tilgængelige på Datafordeleren i løbet af 2. kvartal 2026. Endelig dato udmeldes senere når den er fastlagt. 

De nye entiteter fremgår i Datafordeler Administration fra den 25. februar 2026. Anmodning om dataadgang til de nye entiteter bliver først godkendt, når de sammenstillede fildownload er i drift.





Typer af sammenstillede EJF fildownload


Datafordeleren udstiller 2 typer af sammenstillede fildownload for EJF. Disse er aktuelle totaldownload og aktuelle SincePrevious download. Begge fildownloadtyper genereres både i landsdækkende og kommuneopdelte varianter og er kun tilgængelige i JSON-format, som vist i nedenstående tabel. Logikken til beregning af korrekt kommunal opdeling af de sammenstillede EJF fildownload er kompleks og der henvises derfor til registerets gældende DLS for anvendere som er interesserede i hvordan dette beregnes.

Datafordeleren opbevarer totaldownloads (inklusiv kommuneopdelte) pr. type pr. entitet i 7 dage fra de blev genereret, mens der opbevares SincePrevious fildownload 14 dage fra de blev genereret.


Sammenstillede registre

Type af fildownload

Kommuneopdelte

Type af bitemporal filtrering

Typer af filformater

Genereringsfrekvens

EJF og CPR, kommuneopdelt via EBR

Totaldownload

Ja

Aktuel

JSON

Dagligt

SincePrevious




Der er implementeret 6 forskellige sammenstillede EJF-fildownload, som vist nedenfor. Fildownloads-varianterne med ”Fortrolig” i navnet indeholder EJFs CPR-nummer felter. Fælles for alle disse fildownload er dog at disse tager højde for CPRs navne- og adressebeskyttelse og ikke udstiller beskyttet data for disse personer.


Sammenstillet fildownload navn

Indeholder CPR-numre

Kommuneopdeling understøttes

EjendomsadministratorMedStamoplysninger

Nej

Ja

EjendomsadministratorMedStamoplysningerFortrolig

Ja

EjerskabMedStamoplysninger

Nej

EjerskabMedStamoplysningerFortrolig

Ja

PersonEllerVirksomhedsAdministratorMedStamoplysninger

Nej

PersonEllerVirksomhedsAdministratorMedStamoplysningerFortrolig

Ja






Om SincePrevious typen

I forbindelse med sammenstillede fildownload er der indført en SincePrevious type. Denne type fildownload indeholder et delta, det vil sige den data som har ændret sig siden sidst, men med den meget vigtige forskel at data i et SincePrevious fildownload er blevet yderligere processeret efter denne delta-beregning er udført. Konsekvensen af dette er at data i et SincePrevious fildownload ikke kan bruges til at vedligeholde et kopi-register. Hvis anvendere har behov for dette, skal der i stedet enten bruges entitetsbaserede deltafildownload eller det sammenstillede totaldownload skal bruges.

SincePrevious fildownload indeholder udelukkende data som er blevet redigeret af et af de involverede registre, siden forrige udtræksnummers filer blev genereret. SincePrevious fildownload indeholder derfor ikke data hvor registeret har lavet en fremdatering af data, da registerets sidste redigeringstidspunkt og rækkernes bitemporale tidspunkter ikke nødvendigvis falder inden for samme delta genereringsvindue.






Udtræksnumre og navngivning


De sammenstillede fildownload anvender udtræksnumre på samme måde som de entitetsbaserede fildownload, som beskrevet i afsnittet Udtræksnumre. Bemærk dog at et sammenstillet fildownload er baseret på flere forskellige registre, og dermed er tilknyttet til et specifikt udtræksnummer per register.

Et sammenstillet fildownload er ejet af et specifikt register, og dette registers udtræksnummer anvendes i filnavnet.

Hvis data i det sammenstillede fildownload skal bruges til sammenstilling på tværs af registre, kan udtræksnumrene for de andre involverede registre findes i GetAvailableCustomFiledownloads returværdier.

Navngivning for sammenstillede filer følger næsten samme navngivning som beskrevet i afsnittet Navngivning af fildownload, dog fremgår det ejende registers navn i filnavnet postfikset med ”Custom”.






Sådan henter du sammenstillede fildownload


Sammenstillede fildownload tilgås via samme generelle fremgangsmåde som entitetsbaserede fildownload. Dette er beskrevet i afsnittet Sådan henter du entitetsbaserede fildownload. Dette afsnit antager at du som anvender allerede ved hvordan du henter entitetsbaserede fildownload.

Sammenstillede fildownload bruger en anden metode, GetAvailableCustomFiledownloads, til hentning af tilgængelige filer, men gør brug af samme GetFile metode til hentning af selve filerne.






Metode: GetAvailableCustomFiledownloads

GetAvailableCustomFileDownloads returnerer hvilke sammenstillede fildownload der kan hentes.




Version 1


Metode: GetAvailableCustomFiledownloads

URL

https://<env>-api.datafordeler.dk/FileDownloads/v1.0/GetAvailableCustomFileDownloads?

HTTP-metode

GET

Headere i forespørgsel

Content-Type: application/json

Format

JSON

Returværdier

·         Returnerer HTTP 200:   OK, ved succes.

·         Returnerer HTTP 400:   Bad Request, ved angivelse af forkerte parametre.

·         Returnerer HTTP 404:   Not Found, hvis den angivne ressource ikke kan findes.

·         Returnerer HTTP 500:   Internal Server Error, hvis der er sket en ukendt fejl

Adgang

Tjenesten tillader API-nøgle, OAuth Shared Secret eller OAuth Certifikat.

Bemærk dog at alle EJFs sammenstillede fildownloads kræver godkendt adgang og kun er tilgængelige via OAuth-autentifikation.

Dato- og tidsformat

Datoformat følger ISO 8601
Tidszonen er UTC




Returværdier


Metoden returnerer metadata om fildownload og paging, der følger strukturen beskrevet i tabellen nedenfor. Der er ikke nogen sortering defineret, så resultater optræder i tilfældig rækkefølge.


Felt

Beskrivelse

PaginationMetadata

CurrentPage

Angiver den nuværende side der vises.

PageSize

Angiver antal fildownloads der vises på nuværende side.

TotalCount

Angiver totale fildownloads der findes fra din query.

TotalPages

Angiver totale sider der findes fra din query.

AvailableFileDownloads

Filename

Navnet på filen som kan downloades.

Register

Angiver hvilket register data i filen tilhører.

EntityName

Angiver navnet på registerentiteten som filens data tilhører.

Frequency

Angiver hvornår/hvor ofte der bliver genereret en ny fil af samme type med nyt udtræksnummer.

TypeOfDownload

Angiver om filen er et totaldownload eller et deltadownload.

TypeOfData

Angiver hvilken bitemporal filtrering der er anvendt på data i filen. Denne er altid ”Current”.

Version

Angiver underlæggende version af filens data.

GenerationNumber

Angiver udtræksnummeret.

PointInTime

Angiver tidspunkt for registrerings- og virkningstid der blev anvendt ved generering af fildownload.

Datoformat følger ISO 8601
Tidszonen er UTC

GenerationTime

Angiver tidspunktet for hvornår filen blev genereret. Datoformat følger ISO 8601
Tidszonen er UTC

ExpirationDate

Angiver hvornår filen ikke længere udstilles på Datafordeleren.

Datoformat følger ISO 8601
Tidszonen er UTC

ContainedFileFormat

Angiver hvilket filformat ZIP-filen indeholder.

OutputFileFormat

Angiver filformatet på selve filen som kan downloades.

Md5Hash

Angiver md5 hash på filens indhold og kan bruges til at verificere at filen. Den returnerer null for kommuneopdelte fildownloads, eftersom disse filer ikke understøttes.

FileSizeInBytes

Angiver filstørrelse på filen og kan bruges til at hurtigt at sammenligne filstørrelsen. Den er sat til at være null for kommuneopdelte fildownloads, eftersom disse filer ikke understøttes.

RegisterImportSequenceNumber

Angiver sekvensnummer for dataindlæsning ved generering af fildownload. Kan være ”null” hvis:

  • Registret ikke har moderniserede hændelser
    • Se [C0200-HændelseGuide] for hvilke det gælder
  • Registrets version har ikke moderniserede hændelser
    • Gælder kun DAGI_v1 fildownloads
  • Der er ikke blevet indlæst nye data efter udstilling af RegisterImportSequenceNumber

MunicipalityCode

Den kommunekode det kommuneopdelte fildownload er genereret for, eller ”null” for ikke kommuneopdelte fildownloads.

CustomBaseDataMetadata

En liste af underliggende registre dette sammenstillede fildownload er baseret på, med dertilhørende versionsnumre og udtræksnumre.

CustomBaseDataMetadata

Register

Angiver hvilket register det underliggende sammenstillede data tilhører

Version

Angiver hvilken version af registerets underliggende entitets-baserede data det sammenstillede download bruger til sammenstilling

GenerationNumber

Angiver det underliggende udtræksnummer som er brugt ifm. sammenstillingen af data

RegisterImportSequenceNumber

Angiver det underliggende sekvensnummer for dataindlæsning som er brugt ifm. sammenstillingen af data.