citomni / danish-public-sector-data
Reusable CitOmni clients for authoritative data services provided by the Danish public sector.
Package info
github.com/citomni/danish-public-sector-data
pkg:composer/citomni/danish-public-sector-data
Requires
- php: ^8.5
- citomni/infrastructure: ^1.0.1.1
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Reusable CitOmni clients for authoritative data services provided by the Danish public sector.
Package
citomni/danish-public-sector-data
Repository: https://github.com/citomni/danish-public-sector-data
citomni/danish-public-sector-data is a CitOmni provider package for PHP 8.5+. It exposes small, normalized CitOmni services while keeping upstream API protocols, authentication details, and source-specific data models inside the provider.
The provider currently exposes normalized CVR, BBR, EJF ownership and administrator, VAT-registration, and soil-contamination capabilities backed by the relevant Danish public-sector sources.
Requirements
- PHP 8.5+
- Composer
citomni/kernelcitomni/infrastructure- An enabled
CitOmni\Infrastructure\Boot\Registryin the host app - A Datafordeler IT-system with an API key for non-access-restricted data when using Datafordeler-backed lookups
- A Shared Secret of that IT-system and an approved data access for Ejerfortegnelsen (EJF) when using
ejf
Install
composer require citomni/danish-public-sector-data
Enable the infrastructure provider before this provider in the host app:
<?php declare(strict_types=1); return [ \CitOmni\Infrastructure\Boot\Registry::class, \CitOmni\DanishPublicSectorData\Boot\Registry::class, ];
Datafordeler credentials
Store the credentials in the normal app-local CitOmni secret store. Do not put them in application configuration, templates, JavaScript, or version control.
<?php declare(strict_types=1); return [ 'datafordeler.api_key' => 'YOUR_API_KEY', 'datafordeler.oauth_client_id' => 'YOUR_SHARED_SECRET_CLIENT_ID', 'datafordeler.oauth_client_secret' => 'YOUR_SHARED_SECRET', ];
The active file is selected by CITOMNI_ENVIRONMENT, for example
var/secrets/app.secret.dev.php during local development.
- The API key serves the non-access-restricted data of
bbr,soilContamination(its Matriklen part) andcvr. Only these services need it. - The Shared Secret serves the access-restricted data of
ejf; Datafordeler accepts no API key for Ejerfortegnelsen. The client id and the secret are those of the IT-system's Shared Secret in Datafordeler Administration, and the IT-system needs an approved data access for the EJF entities that the service queries. Onlyejfneeds them.
A Shared Secret client gets an OAuth access token from the token endpoint in cfg
danish_public_sector_data.datafordeler.token_url with the client credentials grant, and
sends it as a bearer token. Every client of the process with the same token endpoint and
client id reuses the token until 60 seconds before it expires, so an HTTP request that uses
ejf asks for one token, and a long CLI run for a new one about every hour. A request that
Datafordeler rejects with 401 or 403 discards the token. Tokens are kept in memory only.
Credential safety
Datafordeleren authenticates API-key requests with the key in the request URL.
The internal Datafordeler client reuses the shared CitOmni curl service and marks
apiKey through sensitive_query_keys. The real value is preserved for the outbound
request, while URLs exposed through Curl metadata, logs, and exceptions are redacted.
Raw transport metadata is not returned by the public CVR service.
The Shared Secret never travels in a URL: the client secret goes only in the form body of
the token request, and the access token only in the Authorization header.
BBR property lookup
The provider exposes bbr for current property data from BBR/DAR through Datafordeler.
The service is BFE-centered internally and supports all three BBR property types:
- samlet fast ejendom (SFE)
- bygning på fremmed grund (BPFG)
- ejerlejlighed
Resolve human-entered auction-style addresses separately from loading the property:
$resolution = $this->app->bbr->resolveAddress('Nørmarkvej 29, 2 22, 7600 Struer'); if ($resolution['selectedBfeNumber'] !== null) { $property = $this->app->bbr->getPropertyByBfe($resolution['selectedBfeNumber']); }
resolveAddress() preserves trailing m.fl. as multiplePropertiesHint=true and returns
primary_resolved_scope_incomplete when the named primary property resolves but the source
explicitly indicates additional auction properties. The service never invents those additional
BFE numbers from the primary address.
DAR's own designation of an address, which resolveAddress() returns as matchedAddress, writes
the supplementary town name just before the postcode, as in
Eksempelvej 10, 2. tv, Tofterup, 7200 Grindsted, where a floor and door would otherwise be read.
When the typed floor and door select no DAR address, resolveAddress() leaves out the parts that
DAR writes as the house number's supplementary town name and selects the address again;
parsed.unit then holds what is left. A part that DAR does not write for the house number is
still read as a floor and door.
Owner-apartment resolution uses the concrete DAR floor/door address and the corresponding BBR unit/property relation. This allows the selected owner apartment to be distinguished from the underlying SFE at the same house number.
BBR registers a building under one house number, so the side entrances of a care home or a
block of flats can have house numbers of their own without any building of their own. When the
buildings and units of the typed house number lead to no property, resolveAddress() follows
the buildings that the house number gives access to: the building DAR names for it
(adgangTilBygning), the buildings of the BBR entrances reached from it (adgangFraHusnummer),
and the building of the unit at the selected address. Their candidates carry the evidence
access_ground_sfe, access_building_bpfg, access_building_ejerlejlighed or
access_unit_ejerlejlighed, and the usual rules apply: one candidate is selected, several are
reported as ambiguous_bfe. Without a selected address the owner apartments in those buildings
are candidates too, as they are for the buildings of the house number itself. An address whose
own house number leads to a property sends no extra request.
Current property data is loaded explicitly by BFE:
$property = $this->app->bbr->getPropertyByBfe('4268969');
The normalized property graph includes relevant addresses, house numbers, grounds, buildings,
units, floors, entrances, and technical installations. Each physical BBR object includes a
scope value so context objects such as an owner apartment's host building or a BPFG property's
underlying ground are not presented as directly belonging to the requested property.
Bundled BBR code-list labels are returned next to their authoritative ...Code values,
including municipality names, floor types, elevator state, and house-number roles. Unknown codes
keep a null label so consumers can fall back to the raw value without guessing.
codeListSnapshotDate identifies the bundled code-list snapshot used for the labels.
The addresses of many properties, such as the properties of one owner in EJF, come without loading each property:
$addresses = $this->app->bbr->getAddressesByBfe([4268969, 4268970]);
It returns one entry per distinct BFE number, keyed by the number in the order the numbers first
occur, with propertyType (sfe, bpfg, ejerlejlighed, or null when BBR has no current
property with the number, or several) and addresses: the DAR designations of the access
addresses of an SFE's grounds, of a BPFG's buildings, and the unit addresses, floor and door
included, of an owner apartment, each once and in natural order. A number with several current
properties lists the addresses of all of them. The numbers go out 100 per request; a batch asks
for the properties, then for the grounds, the building relations and buildings, and the unit
relations and units that its kinds of property need, and the DAR house numbers and addresses of
the whole call follow, 100 per request.
Technical-installation history is opt-in:
$history = $this->app->bbr->getTechnicalInstallationHistory('4268969');
This keeps normal current-state lookups cheaper while still allowing due-diligence workflows to inspect historical BBR technical installations such as former tanks.
Address parsing, deterministic fuzzy-street matching, normalization, the bundled code lists and the field coverage of the queries have a local suite that makes no network requests:
php tests/bbr/run.php
getAddressesByBfe() has a suite of its own, which checks its requests and results against
scripted responses and its query documents against the bundled flexibleCurrent v3 schema,
without network requests:
php tests/bbr-addresses/run.php
The property lookup of resolveAddress(), through the buildings of the house number and through
the buildings it gives access to, and its reading of a supplementary town name have a suite of
their own with scripted responses, which also checks the query documents against the bundled
schema:
php tests/bbr-address-resolution/run.php
Soil contamination lookup
The provider exposes soilContamination for the soil-contamination status that DKjord registers on Danish cadastral parcels. Parcel lookup uses Danmarks Miljøportal's anonymous WFS endpoint; BFE-centered lookup additionally uses Datafordeleren's current Matriklen data to resolve the physical cadastral parcels belonging to the property.
Lookup one exact cadastral parcel by official ejerlav code and matrikelnummer:
$parcel = $this->app->soilContamination->getByParcel(2005352, '311a');
The status comes from the DKjord locality layer DKJord:View_Lokaliteter. Its Lokalitetsmatrikler field lists every parcel of a locality as matrikelnummer,status text entries separated by semicolons, and the status text is the status registered on the parcel itself. The service requests that layer once per ejerlav, without geometry, and matches the matrikelnummer exactly. The result carries:
status: aSoilContaminationStatusvalue (CitOmni\DanishPublicSectorData\Enum):v1,v2,v1_v2,localized,removed_after_mappingorremoved_before_mapping.statusText: DKjord's own text, such asV1 og V2 kortlagt.locations: the DKjord localities that list the parcel, each withlocationReferenceandlocationName.hasDkJordMatch: whether any DKjord locality lists the parcel.
A parcel that no locality lists has hasDkJordMatch=false and status=null; this must not be reworded as proof that the soil is uncontaminated. The lookup throws InvalidResponseException instead of guessing when DKjord lists the parcel with an unknown status text or with two different statuses.
The status is deliberately not derived from the status-declaration layers (View_V1Flader, View_V2Flader, View_LokaliseretFlader, View_UEKFlader, View_UIKFlader). A parcel is often listed in older declarations of its locality as well, so layer membership reports statuses that the parcel no longer has. The public Parcel API described in the DkJord wiki answers HTTP 404.
Påbud, områdeklassificering and nuancering are not part of the result. They appear in the official jordforureningsattest at https://jord.miljoeportal.dk/report/?elav={ejerlavskode}&matrnr={matrikelnummer}.
For property workflows, resolve the physical parcel scope from a BFE number:
$result = $this->app->soilContamination->getByBfe(3208712);
The BFE lookup supports SFE, building-on-foreign-ground, and owner-apartment properties when an underlying SFE exists. It loads current Matriklen parcels, resolves their official ejerlav identifiers, attaches the getByParcel() result as contamination to every parcel, and returns the distinct parcel statuses in statuses. A property without an underlying SFE can return parcelResolutionStatus=no_underlying_sfe without inventing a parcel association. Only Matriklen objects with status Gældende count: the preliminary version (Foreløbig) that a pending cadastral case adds next to the current property is ignored, and two different current objects for one BFE throw InvalidResponseException.
The local normalization/query-contract suite does not make network requests:
php tests/soil-contamination/run.php
CVR lookups
The public CVR service looks up companies by CVR number and production units (P-enheder) by P-number, one number at a time or many per call. It intentionally returns normalized package-owned arrays rather than Datafordeler-specific GraphQL relation names.
$company = $this->app->cvr->getCompany('12345678'); if ($company === null) { // No matching CVR company exists. } $company = $this->app->cvr->getCompany('12345678', withProductionUnits: true); $companies = $this->app->cvr->getCompanies(['12345678', '87654321'], withProductionUnits: true); $unit = $this->app->cvr->getProductionUnit('1234567890'); $units = $this->app->cvr->getProductionUnits(['1234567890', '1234567891']);
With withProductionUnits: true, a company record lists the company's production units in
productionUnits, ordered by P-number: the units that Datafordeler attaches to the company
at the time of the call. The service does not filter them by status or end date. Without
it, productionUnits is null and no production-unit request is sent, so a lookup that
only needs the company itself, such as filling in a form from a CVR number, stays at one
request.
A production-unit record names its company in cvrNumber. Both kinds of record carry
their own name, addresses, contact data and industries. The companies of some production
units are one more call:
$owners = $this->app->cvr->getCompanies(\array_column($units, 'cvrNumber'));
getCompanies() and getProductionUnits() return one entry per distinct number, keyed by
the number in the order the numbers first occur, and null for a number that Datafordeler
does not know. PHP stores these numeric keys as integers, so $companies['12345678'] and
$companies[12345678] read the same entry, and the keys can be passed back in: numbers
are accepted as strings or ints.
Employees
The latest number of employees of companies and production units comes from calls of its own, which read only the CVR entity ids and the employment figures:
$unitEmployees = $this->app->cvr->getProductionUnitEmployees(['1234567890', '1234567891']); $companyEmployees = $this->app->cvr->getCompanyEmployees(['12345678', '87654321']);
They return one entry per distinct number, keyed like getProductionUnits() and
getCompanies():
[ 'count' => 14, 'intervalFrom' => null, 'intervalTo' => null, 'periodStart' => '2026-08-01', 'periodEnd' => '2026-08-31', ]
- The service counts a figure as employees when its type (
beskaeftigelsestalstype) containsAntalAnsatte, and leaves out the others, such as full-time equivalents (AntalAarsvaerk). - Of those, the entry is the figure whose period ends last. Of periods that end on the same day, the shortest wins, so a month comes before the quarter and the year that end with it; then an exact count before an interval; then the latest registration.
countis the exact number when Datafordeler has one. Otherwise it isnull, andintervalFromandintervalTohold the bounds that Datafordeler gives.- An entry is
nullwhen Datafordeler does not know the number, or has no figure of employees for it. - The latest figure can be old: A company without employees for years keeps its last
figure.
periodEndshows its age; the service returns it whatever its age.
Datafordeler cannot filter employment figures by type or period, so the service requests every figure of each company or production unit, its whole history included, and chooses the latest itself.
Requests
Datafordeler accepts at most 100 values in one in filter and returns at most 1000 rows
per page. The service sends one root query per request, batches the numbers 100 at a time,
and requests pages until Datafordeler reports no further page. With one row per company
and production unit, a call takes these requests:
| Call | Requests |
|---|---|
getCompany() |
1 |
getCompany(..., withProductionUnits: true) |
1, plus 1 per started 1000 production units (at least 1) when the company exists |
getCompanies() |
1 per 100 distinct numbers |
getCompanies(..., withProductionUnits: true) |
Per 100 distinct numbers: 1, plus 1 per started 1000 production units (at least 1) of the companies found |
getProductionUnit() |
1 |
getProductionUnits() |
1 per 100 distinct numbers |
getCompanyEmployees() |
Per 100 distinct numbers: 1, plus 1 per started 1000 employment figures (at least 1) of the companies found |
getProductionUnitEmployees() |
Per 100 distinct numbers: 1, plus 1 per started 1000 employment figures (at least 1) of the production units found |
The production units of a company are selected by the company's CVR number rather than by
P-number, so a company with 1,323 production units takes three requests, full
production-unit records included. Every request of one call uses the same effect time
(virkningstid): the time of the call. A page of production units is normalized before
the next page is requested, so only one raw page is held in memory at a time.
Result shapes
Company:
[ 'cvrNumber' => '12345678', 'name' => 'Example ApS', 'status' => 'aktiv', 'startDate' => '2020-01-01', 'endDate' => null, 'companyType' => [ 'code' => '80', 'name' => 'Anpartsselskab', ], 'address' => [ 'type' => 'beliggenhedsadresse', 'formatted' => 'Example Street 12, 7400 Herning', 'careOf' => null, 'street' => 'Example Street', 'houseNumberFrom' => '12', 'houseNumberTo' => null, 'floor' => null, 'door' => null, 'postalCode' => '7400', 'city' => 'Herning', 'supplementaryCity' => null, 'countryCode' => 'DK', 'freeText' => null, ], 'postalAddress' => null, 'contact' => [ 'email' => 'info@example.test', 'phone' => '12345678', 'marketingProtected' => false, ], 'industries' => [ 'primary' => [ 'code' => '000000', 'name' => 'Example industry', 'sequence' => 0, ], 'secondary' => [], ], 'productionUnits' => [ // Production-unit records, as below. ], ]
Production unit:
[ 'pNumber' => '1234567890', 'cvrNumber' => '12345678', 'name' => 'Example ApS', 'status' => 'aktiv', 'startDate' => '2020-01-01', 'endDate' => null, 'attachmentStartDate' => '2020-01-01', 'attachmentEndDate' => null, 'address' => [ // Same shape as the company address. ], 'postalAddress' => null, 'contact' => [ 'email' => 'info@example.test', 'phone' => '12345678', 'marketingProtected' => false, ], 'industries' => [ // Same shape as the company industries. ], ]
startDate and endDate of a production unit are the unit's own start and end;
attachmentStartDate and attachmentEndDate bound its attachment to the company in
cvrNumber.
CVR numbers must have eight digits and P-numbers ten digits, neither starting with 0,
as a string or an int; any other value throws \InvalidArgumentException before a request
is sent. A lookup
returns null when the upstream query returns no node for the number. Integration
failures throw exceptions from CitOmni\DanishPublicSectorData\Exception. The
address.formatted value is built locally from the normalized CVR address fields;
Datafordeler's upstream Adresse value is a DAR address reference rather than formatted
display text.
address continues to prefer the registered location address and falls back to the
postal address for backwards-compatible lookup behavior. postalAddress exposes the
postal address explicitly when CVR supplies one. Industry sequence 0 is normalized as
the primary industry; sequences 1 through 3 are returned as secondary industries.
The normalized CVR records intentionally remain limited to fields exposed by the selected Datafordeler GraphQL contract. Source-specific payloads are not part of them and must not leak into application persistence contracts.
The local suite checks the requests, batching, pagination, normalization and the choice of the latest employee figure against scripted responses, and every query document against the bundled flexibleCurrent v3 schema, without network requests:
php tests/cvr/run.php
The current default uses Datafordeler flexibleCurrent/v3. Host applications can
override the endpoint selection through the normal CitOmni configuration flow:
return [ 'danish_public_sector_data' => [ 'cvr' => [ 'service' => 'flexibleCurrent', 'version' => 'v3', ], ], ];
A service-version change that also changes the GraphQL schema may require a package update; overriding the version does not make incompatible schemas compatible.
EJF ownership lookups
The provider exposes ejf for Ejerfortegnelsen (EJF), the Danish register of who owns
real property, through Datafordeler flexibleCurrent/v3. EJF is access-restricted: the
service authenticates with the Shared Secret (see Datafordeler credentials).
It queries only EJFCustom_EjerskabBegraenset with its ejendePersonBegraenset and
oplysningerEjesAfEjerskab joins, EJF_Ejerskifte with its Handelsoplysninger join and the
EJF_Ejerskabsskifte rows that name it, and
EJFCustom_PersonEllerVirksomhedsadminiBegraenset with its administreretPersonBegraenset,
personBegraenset and personEllerVirksomhedsadministratorErPersonEllerVirksomhedsoplysninger
joins and the EJFCustom_AlternativAdresseBegraenset of that owner information.
Datafordeler refuses a query as a whole when it touches an entity outside the host app's
access, so these are the entities the access must cover. The administrations need only the
methods under Administrators.
$ownerships = $this->app->ejf->getOwnerships([4268969]); $transfers = $this->app->ejf->getTransfers([4268969]);
Both return one entry per distinct BFE number, keyed by the number in the order the numbers first occur, with an empty list for a property that EJF has nothing on. Numbers are accepted as ints or as strings of digits without leading zeroes.
The properties of a company owner are found by its CVR number:
$ownerships = $this->app->ejf->getCompanyOwnerships('12345678');
It returns the company's own ownerships, current and former, keyed by BFE number in
ascending order, each list in the order and shape of getOwnerships(). The other owners
and the transfers of those properties come from getOwnerships() and getTransfers().
A former ownership is the version that ended it, so its validFrom is the day the company
stopped owning the property, not the day it started.
getOwnerships()lists the ownerships of the property, current and former, oldest first byvalidFrom. EJF answers with former ownerships at every effect time, so the list is the ownership history of the property, withcurrenttrue for the owners now (statusgældende) and false for the former ones (statushistorisk).getTransfers()lists the ownership changes (Ejerskifte) with their trade information and their share transfers, oldest first bytakeoverDate. Rolled-back registrations (statustilbagerullet) are left out, of transfers and of share transfers.- EJF stores calendar dates as instants of Danish midnight. The service returns them as
Danish dates,
YYYY-MM-DD, and EJF's placeholders for an unknown date, the start of the year 1, 1 January 1800 and 1 January 1970, asnull. - EJF withholds the name and the address of a person with name and address protection, so
name,addressandaddressingNamearenullfor that person;protectionslists the kinds of protection, such asnavne_og_adresse. - A deceased or emigrated person has no address in Denmark (
addressisnull); an emigrated person may haveforeignAddress. ownerTypeis anEjfOwnerTypevalue (CitOmni\DanishPublicSectorData\Enum):person,company,other(an owner without CPR or CVR number, registered by a municipality, such as a foreign owner or an estate) orunknown.- One trade can cover several properties for one price;
trade.bfeNumberslists them, at most 100. - The conversion from the former ownership register split a deed with several buyers into one transfer per buyer, each with an even part of the price and the share transfers of the whole deed. The lists keep the parts.
Administrators
An administration (CustomPersonEllerVirksomhedsadminiBegraenset) names who administers a
person or a company, such as the estate of a deceased person. EJF offers no filter on the
administered person, so a host app reads the administrations by the EJF import batches that
brought them, or by registration time, and then the administrators of those it needs:
$entries = $this->app->ejf->getImportedAdministrationEntries(454989, 456989); $entries = $this->app->ejf->getRegisteredAdministrationEntries(new \DateTimeImmutable('2026-11-01T00:00:00Z'), new \DateTimeImmutable('2026-11-08T00:00:00Z')); $entries = $this->app->ejf->getAdministrationEntries([627801]); $administrations = $this->app->ejf->getAdministrations([627801]);
- An entry is an administration without its administrator: its id, object id, import batch,
status, registration time, effect date, business event and process, and the administered
party, with the id, CPR status, status date and birth date of a person. For a person with
status
doed, the status date is the date of death. getImportedAdministrationEntries()lists every administration whose current registration came with an import batch from the first number up to but not including the second, new or changed. EJF numbers its import batches (datafordelerRegisterImportSequenceNumber) in one series across its entities, so a host app that keeps the newest batch it has read can read the changes since. The list comes oldest batch first, then by object id.getRegisteredAdministrationEntries()lists the administrations whose current registration was made in a period, to the second, in the same order; it finds the batches of a period.getAdministrationEntries()andgetAdministrations()look up administrations by object id, keyed by object id in the order the ids first occur. An id without an administration has no entry.getAdministrations()adds the administrator.administeredTypeandadministratorTypeareEjfPartyTypevalues (CitOmni\DanishPublicSectorData\Enum):person,company,production_unit(the administrator only),other(a party without CPR or CVR number) orunknown.currentis true for statusgældende. Ended administrations (historisk) and rolled-back registrations (tilbagerullet) are returned with their status.- Datafordeler pages a range in object id order, not in batch order, so a range is read in full only when every page of it has been read.
Requests
The service sends the numbers and object ids 100 per request and asks for pages of 100 rows, or of 500 entries for a range of administrations. Every request of one call uses the same effect time: the time of the call. The first request of a process with a Shared Secret is preceded by a token request.
| Call | Requests |
|---|---|
getOwnerships() |
Per 100 distinct numbers: 1 per started 100 ownerships (at least 1) |
getCompanyOwnerships() |
1 per started 100 ownerships of the company (at least 1) |
getTransfers() |
Per 100 distinct numbers: 1 per started 100 transfers (at least 1) |
getImportedAdministrationEntries(), getRegisteredAdministrationEntries() |
1 per started 500 entries (at least 1) |
getAdministrationEntries(), getAdministrations() |
1 per 100 distinct object ids |
Result shapes
Ownership:
[ 'id' => 'a7f6...', 'bfeNumber' => 4268969, 'status' => 'gældende', 'current' => true, 'validFrom' => '2019-07-01', 'ownershipCode' => '10', 'share' => ['numerator' => 1, 'denominator' => 2], 'registeredShare' => ['numerator' => 1, 'denominator' => 2], 'primaryContact' => true, 'businessEvent' => 'Endeligt skøde', 'businessProcess' => 'Hændelse fra Digital Tinglysning', 'ownerType' => 'person', 'person' => [ 'id' => '5c1e...', 'status' => 'bopael_i_danmark', 'statusDate' => '2015-03-01', 'statusDateUncertain' => false, 'birthDate' => '1950-06-15', 'birthDateUncertain' => false, 'name' => 'Example Owner', 'protections' => ['markedsfoering'], 'address' => [ 'line' => 'Eksempelvej 12, 2. tv', 'street' => 'Eksempelvej', 'houseNumber' => '12', 'floor' => '02', 'door' => 'tv', 'building' => null, 'city' => null, 'postalCode' => '7400', 'postalDistrict' => 'Herning', 'municipalityCode' => '0657', 'municipalityName' => 'Herning', 'roadCode' => '1234', 'formatted' => 'Eksempelvej 12, 2. tv, 7400 Herning', ], 'addressingName' => 'Example Owner', 'foreignAddress' => null, ], 'companyCvr' => null, 'other' => null, ]
validFromis the day the ownership took effect in EJF. It is not always the day the owner took over; for some ownerships it is the filing date of the deed.shareis the actual share (faktisk ejerandel) andregisteredSharethe share in the land register (tinglyst ejerandel), both as EJF holds them, unreduced, andnullwhen EJF has none.person.statusDateis the date of the CPR status; for statusdoedit is the date of death.person.ididentifies the person across the ownerships of one answer.address.lineis the street, house number, floor and door as CPR writes them;formattedadds the city and the postcode.municipalityCodeandroadCodeare the CPR codes of the address.companyCvris the CVR number of a company owner.otherholdsname,addressLinesand the numericcountryCodeof an owner without CPR or CVR number.
Transfer:
[ 'id' => '3b9d...', 'objectId' => 307123456, 'bfeNumber' => 4268969, 'takeoverDate' => '2019-07-01', 'filedDate' => '2019-07-11', 'method' => 'Almindelig fri handel', 'businessEvent' => 'Endeligt skøde', 'businessProcess' => 'Hændelse fra Digital Tinglysning', 'conditional' => false, 'deadline' => null, 'documentId' => '1007...', 'trade' => [ 'id' => '9e42...', 'totalPrice' => 1250000.0, 'cashPrice' => 1250000.0, 'movablesPrice' => null, 'currency' => 'DKK', 'contractDate' => '2019-05-02', 'disposalDate' => '2019-05-02', 'paymentDate' => null, 'buildings' => 'Enfamiliesejendom', 'bfeNumbers' => [4268969], ], 'shareTransfers' => [ [ 'id' => '5c01...', 'givingOwnershipId' => '1d7f...', 'givenShare' => ['numerator' => 1, 'denominator' => 1], 'receivingOwnershipId' => null, 'receivedShare' => null, ], [ 'id' => '8a22...', 'givingOwnershipId' => null, 'givenShare' => null, 'receivingOwnershipId' => '6e90...', 'receivedShare' => ['numerator' => 1, 'denominator' => 2], ], ], ]
takeoverDateis the overtagelsesdato,filedDatethe anmeldelsesdato, anddocumentIdthe identifier of the filed document in the land register.methodis the overdragelsesmaade, such asAlmindelig fri handelorAnden overdragelse. A forced sale shows inbusinessEvent(Meddelelse om tvangsauktion,Auktionsskøde), not inmethod.trade.totalPriceis the samlet købesum,cashPricethe kontant købesum andmovablesPricethe løsøresum, incurrency;disposalDateis the afståelsesdato.tradeisnullwhen EJF has no trade information for the transfer.shareTransfersare the transfer's share transfers (Ejerskabsskifte) with statusgældende, ordered byid. Each names the ownership that gives up a share, withgivenSharethe part of its own share that it gives up, or the ownership that receives one, withreceivedSharethe part of the property that it receives. The ownership ids are theidof the ownerships ofgetOwnerships(), so the shares tell which ownerships a transfer ended and began. A transfer with more than 1000 share transfers fails the lookup.objectIdis EJF's object id of the transfer,nullwhen EJF gives none.
Administration:
[ 'id' => '0f3c...', 'objectId' => 627801, 'importSequence' => 454989, 'status' => 'gældende', 'current' => true, 'registeredAt' => '2026-11-05T14:09:59Z', 'validFrom' => '2026-10-30', 'businessEvent' => 'Person død', 'businessProcess' => 'Hændelse fra CPR', 'administeredType' => 'person', 'administeredPerson' => [ 'id' => '7d2a...', 'status' => 'doed', 'statusDate' => '2026-10-30', 'birthDate' => '1941-03-09', ], 'administeredCvr' => null, 'administeredOtherId' => null, 'administratorType' => 'other', 'administratorPerson' => null, 'administratorCvr' => null, 'administratorPNumber' => null, 'administratorOtherId' => '41b8...', 'administratorOther' => [ 'name' => 'Example Heir', 'addressLines' => ['Example Street 2', '7400 Herning'], 'countryCode' => '999', 'alternativeAddress' => [ 'status' => 'gældende', 'current' => true, 'lines' => ['c/o Example Law', 'Example Square 1', '7400 Herning'], 'countryCode' => '999', ], ], ]
- An entry has the keys up to
administeredOtherId. registeredAtis the registration time (registreringFra) in UTC, to the second.validFromis the day the administration took effect; for an estate it is usually the date of death, but not always.administratorPersonhas the shape of the person of an ownership.administratorCvr,administratorPNumberandadministratorOtherIdare returned whatever the type, so a company that names a production unit keeps both numbers.alternativeAddressis the address for post to an administrator without CPR or CVR number;nullwhen EJF names none.
The local suite checks the Shared Secret flow, the requests, batching, pagination and normalization against scripted responses, and every query document against the bundled flexibleCurrent v3 schema, without network requests:
php tests/ejf/run.php
Host applications can override the endpoint selection like the CVR one, under
danish_public_sector_data.ejf.service and danish_public_sector_data.ejf.version.
VAT registration lookup
The provider also exposes vatRegistration. Its current implementation checks one exact
CVR/SE number through SKAT's anonymous public VAT-number web lookup:
$status = $this->app->vatRegistration->getStatus('12345678');
The normalized result contains the queried number, the decisive current registration state,
the displayed verification date when available, and skat.dk as source. The web transport
is deliberately isolated because the public SKAT page is not a documented API contract.
No CAPTCHA, login, or access control is bypassed. The exact queried CVR/SE number is retained
because a legal CVR number may use separate administrative SE numbers for VAT registration.
The parser suite covers the observed CVR/SE search controls plus decisive positive and negative result wording without making a live network request:
php tests/vat-registration/run.php
Internal Datafordeler client
Datafordeler authentication and GraphQL transport are internal package concerns.
Support\DatafordelerClient is instantiated by public package services as needed and
is deliberately not registered in the host application's service map.
Each service chooses the credentials its data needs with
Enum\DatafordelerAuthentication: the API key for non-access-restricted data, the
Shared Secret for access-restricted data such as EJF.
Architecture
The provider keeps the boundaries intentionally small:
Service\Bbrresolves DAR addresses and returns normalized BBR property data.Service\SoilContaminationresolves physical Matriklen parcels and returns normalized DKjord soil-contamination data.Service\Cvris the public CVR capability and owns CVR-specific queries and normalization.Service\Ejfreturns normalized ownerships, transfers and administrations from Ejerfortegnelsen.Service\VatRegistrationis the public VAT-registration status capability.Support\DatafordelerClientowns Datafordeler authentication with the API key or the Shared Secret and its access tokens, GraphQL transport, response validation, and safe exception translation.Support\DkJordWfsClientisolates anonymous DKjord WFS transport and GeoJSON response validation.Support\SkatVatWebClientisolates the temporary public SKAT web-flow transport details.Exceptioncontains transport-agnostic integration failure semantics.Enumholds vocabularies that host apps store, such asSoilContaminationStatus,EjfOwnerTypeandEjfPartyType, and the choice of Datafordeler credentials,DatafordelerAuthentication.- No SQL, HTTP controller behavior, or CLI output belongs in these services.
New public-sector sources should be added only when there is a concrete consumer. Do not force unrelated REST, GraphQL, geospatial, or file-download APIs behind one artificial generic abstraction.
Configuration and services
The provider contributes these shared service IDs:
bbrsoilContaminationcvrvatRegistrationejf
Internal transport helpers are not registered as host-app services.
Package-owned defaults live under danish_public_sector_data in
src/Boot/Registry.php and may be overridden by the host app through normal
CitOmni configuration precedence. The services read these keys directly, so the
baseline is the only source of their defaults. A local suite checks every cfg read
in src/ against the baseline:
php tests/cfg-reads/run.php
Develop the package
Install the dependencies in the package root and run every suite. The suites make no network
requests. Each suite folder in tests/ has a README with its checks and expected totals.
composer install
composer test
Data and licensing
The package source code is released under the MIT License. Data retrieved from public-sector services remains subject to the terms, licences, access conditions, and other rules of the respective data provider. This package does not grant any rights to third-party or public-sector data.
Coding conventions
- PHP 8.5+
- PSR-1 / PSR-4
- PascalCase classes
- camelCase methods and variables
- UPPER_SNAKE_CASE constants
- K&R braces
- Tabs for indentation
- PHPDoc and inline comments in English
- Fail fast unless a failure is genuinely recoverable
License
citomni/danish-public-sector-data is released under the MIT License.
See LICENSE and NOTICE.
Trademarks
See TRADEMARKS.md for the CitOmni trademark notice
applicable to this package.