Segments
Filter companies, persons and properties, and fetch the segments you have purchased. A filter lookup returns the count and the first 3 matches; the full list comes from a purchased segment.
| Method | Path | Description |
|---|---|---|
GET |
/person/segments |
Filter persons by segment criteria |
GET |
/company/segments |
Filter companies by segment criteria |
GET |
/property/segments |
Filter properties by segment criteria |
GET |
/segments/downloads |
List purchased segments |
GET |
/segments/downloads/{id} |
Get one purchased segment, with its matched entities |
Filter persons by segment criteria
GET /person/segmentsScope: persons · Quota: counts against the quota
Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.
Parameters
| Parameter | Type | Description |
|---|---|---|
sort |
string | Sort field. name_normalized, birthday, carrier_started, zip, city, district, region, status, companies_count, connections_count, properties_count · default name_normalized |
direction |
string | asc, desc · default desc |
page |
integer | Ignored: the preview always returns the first 3 matches. |
limit |
integer | Ignored: the preview always returns the first 3 matches. |
is_ |
string | Only active business persons. 0, 1 |
is_ |
string | Only inactive business persons. 0, 1 |
is_ |
string | Exclude address-protected persons. 0, 1 |
has_ |
string | Only persons who own a holding company. 0, 1 |
has_ |
string | Only persons who own property. 0, 1 |
regions[] |
array<string> | Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland) |
districts[] |
array<string> | Municipality codes. |
cities[] |
array<string> | City names (postal district) |
roles[] |
array<string> | Roles held in companies: director (Direktør), board_member (Bestyrelsesmedlem), owner (Ejer), founder (Stifter), representative (Repræsentant), auditor (Revisor), store_manager (Uddeler), beneficial_owner (Reel ejer) |
sectors[] |
array<integer> | CVR sector codes. |
company_ |
array<string> | Cross-filter: the person’s company region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland) |
company_ |
array<string> | Company form codes: 60 (A/S), 80 (ApS), 81 (IVS), 100 (Fund), other. |
zip_ |
integer | Zip code from. 1000–9999 |
zip_ |
integer | Zip code to. 1000–9999 |
companies_ |
integer | Number of companies from. 1–100 |
companies_ |
integer | Number of companies to. 1–100 |
connections_ |
integer | Number of connections from. 0–9999 |
connections_ |
integer | Number of connections to. 0–9999 |
carrier_ |
integer | Career length from (years) 0–99 |
carrier_ |
integer | Career length to (years) 0–99 |
revenue_ |
integer | Revenue from (t.DKK) |
revenue_ |
integer | Revenue to (t.DKK) |
profit_ |
integer | Profit before tax from (t.DKK) |
profit_ |
integer | Profit before tax to (t.DKK) |
equity_ |
integer | Equity from (t.DKK) |
equity_ |
integer | Equity to (t.DKK) |
holding_ |
integer | Holding equity from (t.DKK) |
holding_ |
integer | Holding equity to (t.DKK) |
holding_ |
integer | Holding profit before tax from (t.DKK) (Insights all) |
holding_ |
integer | Holding profit before tax to (t.DKK) (Insights all) |
holding_ |
integer | Holding cash from (t.DKK) (Insights all) |
holding_ |
integer | Holding cash to (t.DKK) (Insights all) |
holding_ |
integer | Holding debt from (t.DKK) (Insights all) |
holding_ |
integer | Holding debt to (t.DKK) (Insights all) |
holding_ |
integer | Holding company age from (years) (Insights all) 0–99 |
holding_ |
integer | Holding company age to (years) (Insights all) 0–99 |
age_ |
integer | Person age from (years) (Premium) 0–99 |
age_ |
integer | Person age to (years) (Premium) 0–99 |
properties_ |
integer | Number of owned properties from. 0–999 |
properties_ |
integer | Number of owned properties to. 0–999 |
statuses[] |
array<string> | Company status values — as status of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted. |
employees_ |
integer | Number of employees from. 0–99999 |
employees_ |
integer | Number of employees to. 0–99999 |
founded_ |
string (date) | Company founded date from. |
founded_ |
string (date) | Company founded date to. |
accounted_ |
string (date) | Latest report date from. |
accounted_ |
string (date) | Latest report date to. |
gross_ |
integer | Gross profit from (t.DKK) |
gross_ |
integer | Gross profit to (t.DKK) |
cash_ |
integer | Liquid assets from (t.DKK) |
cash_ |
integer | Liquid assets to (t.DKK) |
receivables_ |
integer | Receivables from (t.DKK) |
receivables_ |
integer | Receivables to (t.DKK) |
employee_ |
integer | Staff expenses from (t.DKK) |
employee_ |
integer | Staff expenses to (t.DKK) |
liabilities_ |
integer | Debt liabilities from (t.DKK) |
liabilities_ |
integer | Debt liabilities to (t.DKK) |
property_ |
array<string> | Property types: matrikuleret_areal (SFE), ejerlejlighed (apartment), bpfg (bygning paa fremmed grund) |
property_ |
array<string> | Property city names. |
property_ |
array<string> | BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed med eget køkken), 2 (Blandet bolig og erhverv med eget køkken), 3 (Enkeltværelse uden eget køkken), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig) |
property_ |
array<integer> | BBR usage codes: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 131 (Række-/kæde-/klyngehus), 132 (Dobbelthus), 140 (Bolig i etageejendom/flerfamiliehus), 150 (Kollegiebolig), 160 (Bolig i døgninstitution), 185 (Anneks til helårsbolig), 190 (Anden helårsbeboelse), 211 (Stald til svin), 212 (Stald til kvæg/får), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder/afgrøder), 217 (Maskinhus/garage), 218 (Lade til halm/hø), 219 (Anden landbrugsenhed), 221 (Industri med integreret produktion), 222 (Industri uden integreret produktion), 223 (Værksted), 229 (Anden produktionsenhed), 231 (Energiproduktion), 232 (Forsyningsdistribution), 233 (Vandforsyning), 234 (Affald og spildevand), 239 (Anden energienhed), 311 (Jernbane- og busdrift), 312 (Luftfart), 313 (Parkerings- og transportanlæg), 314 (Parkering til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 321 (Kontor), 322 (Detailhandel), 323 (Lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden kontor/handel/lager), 331 (Hotel/kro/konferencecenter med overnatning), 332 (Bed & breakfast), 333 (Restaurant/café/konferencecenter), 334 (Privat servicevirksomhed), 339 (Anden serviceenhed), 411 (Biograf/teater/koncertsted), 412 (Museum), 413 (Bibliotek), 414 (Kirke/trosudøvelse), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden kulturenhed), 421 (Grundskole), 422 (Universitet), 429 (Anden undervisningsenhed), 431 (Hospital og sygehus), 432 (Hospice/behandlingshjem), 433 (Sundhedscenter/lægehus/fødeklinik), 439 (Anden sundhedsenhed), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel/arresthus), 449 (Anden institutionsenhed), 451 (Beskyttelsesrum), 510 (Sommerhus), 521 (Feriecenter/campingplads), 522 (Ferielejlighed til erhvervsmæssig udlejning), 523 (Ferielejlighed til eget brug), 529 (Anden ferieenhed), 531 (Klubhus/fritid og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune/stadion), 535 (Hesteopstaldning), 539 (Anden idrætsenhed), 540 (Kolonihavehus), 585 (Anneks til fritids-/sommerhus), 590 (Anden fritidsenhed) |
property_ |
integer | Property zip from. 1000–9999 |
property_ |
integer | Property zip to. 1000–9999 |
property_ |
integer | Plot area from (m2) ≥ 0 |
property_ |
integer | Plot area to (m2) ≥ 0 |
property_ |
integer | Residence area from (m2) ≥ 0 |
property_ |
integer | Residence area to (m2) ≥ 0 |
property_ |
integer | Purchase price from (usually in DKK) ≥ 0 |
property_ |
integer | Purchase price to (usually in DKK) ≥ 0 |
property_ |
string (date) | Acquisition date from. |
property_ |
string (date) | Acquisition date to. |
property_ |
string (date) | Deed date from (Premium) |
property_ |
string (date) | Deed date to (Premium) |
property_ |
string (date) | Last endorsement date from (Premium) |
property_ |
string (date) | Last endorsement date to (Premium) |
property_ |
array<string> | Property region codes: capital, central, north, south, zealand. |
property_ |
array<string> | Property municipality codes. |
property_ |
array<string> | Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel særlige vilkår. |
property_ |
array<integer> | Property ownership state codes: 10 (Privatpersoner), 20 (Alment boligselskab), 30 (Selskab), 40 (Forening/legat), 41 (Andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet) |
property_ |
integer | Property business area from (m2) ≥ 0 |
property_ |
integer | Property business area to (m2) ≥ 0 |
property_ |
integer | Property number of rooms from. 0–1000 |
property_ |
integer | Property number of rooms to. 0–1000 |
property_ |
integer | Property number of toilets from. 0–1000 |
property_ |
integer | Property number of toilets to. 0–1000 |
property_ |
integer | Property number of bathrooms from. 0–1000 |
property_ |
integer | Property number of bathrooms to. 0–1000 |
Example
curl "https://ownr.dk/api/v2/person/segments?zip_from=2900&zip_to=2900" \ -H "Authorization: Bearer ACCESS_TOKEN"{ "status": "success", "data": { "items": [ { "item": { "id": 4004068725, "slug": "person", "url": "/api/v2/person/4004068725", "name": "Jesper Buch" }, "is_active": true, "birthday": "1975-03-14", "companies_count": 3, "connections_count": 12, "zip": "2100", "city": "Kobenhavn O", "postal_district": "København Ø" } ], "count": 142 }}Fields in the response
| Field | Type | Description |
|---|---|---|
data |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 4004068725 |
data. |
string | default person |
data. |
string | e.g. /api/v2/person/4004068725 |
data. |
string | e.g. Jesper Buch |
data. |
boolean | e.g. true |
data. |
string (date) | e.g. 1975-03-14 |
data. |
integer | e.g. 3 |
data. |
integer | e.g. 12 |
data. |
string | e.g. 2100 |
data. |
string | Locality of the address, empty when the address has none. e.g. Kobenhavn O |
data. |
string | City of the zip code. e.g. København Ø |
data. |
integer | The total number of matches — items is capped to the first 3 regardless of this number. e.g. 142 |
Errors
| Status | Meaning |
|---|---|
400 |
No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values |
401 |
Missing, invalid or expired access token |
403 |
The access token does not have the scope this endpoint needs |
429 |
Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded |
Filter companies by segment criteria
GET /company/segmentsScope: companies · Quota: counts against the quota
Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.
Parameters
| Parameter | Type | Description |
|---|---|---|
sort |
string | Sort field. last_cvr_report.changed, founded, employees_number, ceased, last_cvr_report.ProfitLossBeforeTax, last_cvr_report.Equity, last_cvr_report.GrossProfit, last_cvr_report.CashAndCashEquivalents, last_cvr_report.ShorttermReceivables, last_cvr_report.ShorttermInvestments, last_cvr_report.EmployeeBenefitsExpense, last_cvr_report.LiabilitiesOtherThanProvisions, zip · default last_cvr_report.changed |
direction |
string | asc, desc · default desc |
page |
integer | Ignored: the preview always returns the first 3 matches. |
limit |
integer | Ignored: the preview always returns the first 3 matches. |
active |
string | Only active companies. 0, 1 |
is_ |
string | Only inactive companies. 0, 1 |
has_ |
string | Only companies with contact info. 0, 1 |
reports |
string | Only companies with filed reports. 0, 1 |
auditor |
string | Only companies with an auditor. 0, 1 |
advertising_ |
string | Exclude advertising-protected companies. 0, 1 |
regions[] |
array<string> | Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland, companies with a Greenland address) |
districts[] |
array<string> | Municipality codes. |
cities[] |
array<string> | City names (postal district) |
sectors[] |
array<integer> | CVR sector codes. |
types[] |
array<integer> | Company form codes: 10 (ENK/Enkeltmandsvirksomhed), 15 (PMV), 20 (DØD/Dødsbo), 30 (I/S/Interessentskab), 40 (K/S/Kommanditselskab), 45 (MSS), 50 (PAR/Partrederi), 60 (A/S/Aktieselskab), 70 (KAS/Kommanditaktieselskab), 80 (APS/Anpartsselskab), 81 (IVS/Iværksætterselskab), 90 (FON/Fonde), 95 (TRU/Trust), 100 (EFO/Erhvervsdrivende fond), 110 (FOR/Forening), 115 (FFO/Frivillig forening), 130 (ANS/Andelsselskab), 140 (ABA), 150 (FBA), 151 (SMA), 152 (FMA), 160 (EØF), 170 (FAS), 180 (FAP), 190 (FBA), 195 (SCE), 210 (UDL), 220 (FEØ), 230 (STA/Statslig enhed), 235 (SOV), 240 (AMT), 245 (REG/Region), 250 (KOM/Primærkommune), 260 (FKI), 270 (EUO), 280 (ØVR), 285 (FIV), 290 (E/S), 291 (FES), 520 (GUS), 990 (UOP) |
statuses[] |
array<string> | Company status values — as status of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted. |
zip_ |
integer | Zip code from. 1000–9999 |
zip_ |
integer | Zip code to. 1000–9999 |
age_ |
integer | Company age from (years) (Premium) 0–200 |
age_ |
integer | Company age to (years) (Premium) 0–200 |
employees_ |
integer | Number of employees from. ≥ 0 |
employees_ |
integer | Number of employees to. ≥ 0 |
founded_ |
string (date) | Founded date from. |
founded_ |
string (date) | Founded date to. |
ceased_ |
string (date) | Ceased date from. |
ceased_ |
string (date) | Ceased date to. |
accounted_ |
string (date) | Latest report date from. |
accounted_ |
string (date) | Latest report date to. |
properties_ |
integer | Number of owned properties from (Premium) 0–999 |
properties_ |
integer | Number of owned properties to (Premium) 0–999 |
Profit |
integer | Profit before tax from (t.DKK) |
Profit |
integer | Profit before tax to (t.DKK) |
Equity_ |
integer | Equity from (t.DKK) |
Equity_ |
integer | Equity to (t.DKK) |
Gross |
integer | Gross profit from (t.DKK) |
Gross |
integer | Gross profit to (t.DKK) |
Cash |
integer | Liquid assets from (t.DKK) |
Cash |
integer | Liquid assets to (t.DKK) |
Shortterm |
integer | Receivables from (t.DKK) |
Shortterm |
integer | Receivables to (t.DKK) |
Shortterm |
integer | Short term investments from (t.DKK) |
Shortterm |
integer | Short term investments to (t.DKK) |
Employee |
integer | Staff expenses from (t.DKK) |
Employee |
integer | Staff expenses to (t.DKK) |
Liabilities |
integer | Debt liabilities from (t.DKK) |
Liabilities |
integer | Debt liabilities to (t.DKK) |
property_ |
array<string> | Property city names. |
property_ |
array<string> | Property region codes: capital, central, north, south, zealand. |
property_ |
array<string> | Property municipality codes. |
property_ |
integer | Property zip from. 1000–9999 |
property_ |
integer | Property zip to. 1000–9999 |
property_ |
array<string> | BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed), 2 (Blandet bolig og erhverv), 3 (Enkeltværelse), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig) |
property_ |
array<integer> | BBR unit usage codes. |
property_ |
array<string> | Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel særlige vilkår. |
property_ |
array<integer> | Property ownership state codes: 10 (Privatpersoner), 20 (Alment boligselskab), 30 (Selskab), 40 (Forening/legat), 41 (Andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet) |
property_ |
integer | Property purchase price from (usually in DKK) ≥ 0 |
property_ |
integer | Property purchase price to (usually in DKK) ≥ 0 |
property_ |
string (date) | Property acquisition date from. |
property_ |
string (date) | Property acquisition date to. |
property_ |
string (date) | Property deed date from (Premium) |
property_ |
string (date) | Property deed date to (Premium) |
property_ |
string (date) | Property last endorsement date from (Premium) |
property_ |
string (date) | Property last endorsement date to (Premium) |
property_ |
integer | Property plot area from (m2) ≥ 0 |
property_ |
integer | Property plot area to (m2) ≥ 0 |
property_ |
integer | Property residence area from (m2) ≥ 0 |
property_ |
integer | Property residence area to (m2) ≥ 0 |
property_ |
integer | Property business area from (m2) ≥ 0 |
property_ |
integer | Property business area to (m2) ≥ 0 |
property_ |
integer | Property number of rooms from. 0–1000 |
property_ |
integer | Property number of rooms to. 0–1000 |
property_ |
integer | Property number of toilets from. 0–1000 |
property_ |
integer | Property number of toilets to. 0–1000 |
property_ |
integer | Property number of bathrooms from. 0–1000 |
property_ |
integer | Property number of bathrooms to. 0–1000 |
person_ |
array<string> | Cross-filter: only companies with a related person from these region codes. |
person_ |
array<string> | Cross-filter: related person’s municipality codes. |
person_ |
array<string> | Cross-filter: related person’s city names. |
person_ |
integer | Cross-filter: related person’s zip from. 1000–9999 |
person_ |
integer | Cross-filter: related person’s zip to. 1000–9999 |
person_ |
integer | Cross-filter: related person’s number of companies from. ≥ 1 |
person_ |
integer | Cross-filter: related person’s number of companies to. ≥ 1 |
person_ |
integer | Cross-filter: related person’s number of connections from. ≥ 0 |
person_ |
integer | Cross-filter: related person’s number of connections to. ≥ 0 |
person_ |
integer | Cross-filter: related person’s career length from (years) 0–99 |
person_ |
integer | Cross-filter: related person’s career length to (years) 0–99 |
person_ |
integer | Cross-filter: related person’s age from (Premium) 0–99 |
person_ |
integer | Cross-filter: related person’s age to (Premium) 0–99 |
Example
curl "https://ownr.dk/api/v2/company/segments?statuses[]=UNDER%20KONKURS" \ -H "Authorization: Bearer ACCESS_TOKEN"{ "status": "success", "data": { "items": [ { "item": { "id": 36732261, "slug": "company", "url": "/api/v2/company/36732261", "name": "SNT ApS" }, "status": "AKTIV", "founded": "2010-06-15", "ceased": null, "employees_number": 12, "zip": "1620", "city": "Kobenhavn V", "sector": { "code": 620100, "text": "Udvikling og produktion af software" } } ], "count": 842 }}Fields in the response
| Field | Type | Description |
|---|---|---|
data |
object | |
data. |
array<object> | |
data. |
object | |
data. |
integer | e.g. 36732261 |
data. |
string | default company |
data. |
string | e.g. /api/v2/company/36732261 |
data. |
string | e.g. SNT ApS |
data. |
string | e.g. AKTIV |
data. |
string (date) | e.g. 2010-06-15 |
data. |
string (date) | |
data. |
integer | e.g. 12 |
data. |
string | e.g. 1620 |
data. |
string | e.g. Kobenhavn V |
data. |
object | |
data. |
integer | e.g. 620100 |
data. |
string | e.g. Udvikling og produktion af software |
data. |
integer | The total number of matches — items is capped to the first 3 regardless of this number. e.g. 842 |
Errors
| Status | Meaning |
|---|---|
400 |
No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values |
401 |
Missing, invalid or expired access token |
403 |
The access token does not have the scope this endpoint needs |
429 |
Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded |
Filter properties by segment criteria
GET /property/segmentsScope: properties · Quota: counts against the quota
Preview endpoint — returns only the first 3 matches. Buy the full segment (see the segments/downloads endpoints) to get the complete result set.
Parameters
| Parameter | Type | Description |
|---|---|---|
sort |
string | Sort field. Tinglysning.loan_update_date, LastPurchase.total_purchase_price, LastPurchase.acquisition_date, Tinglysning.purchase_agreement_date, Tinglysning.tinglysnings_date, ownership_state_code, Plot.registered_area, Unit.area_for_residence, Unit.area_for_business, Unit.number_of_rooms, Unit.number_of_toilets, Unit.number_of_bathrooms, zip · default LastPurchase.acquisition_date |
direction |
string | asc, desc · default desc |
page |
integer | Ignored: the preview always returns the first 3 matches. |
limit |
integer | Ignored: the preview always returns the first 3 matches. |
owner_ |
string | Only properties owned by a private person. 0, 1 |
owner_ |
string | Only properties owned by a company. 0, 1 |
has_ |
string | Only properties with a BFE number. 0, 1 |
regions[] |
array<string> | Region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland) |
districts[] |
array<string> | Municipality codes. |
cities[] |
array<string> | City names (postal district) |
types[] |
array<string> | Property types: matrikuleret_areal (SFE), ejerlejlighed (apartment), bpfg (bygning paa fremmed grund) |
unit_ |
array<string> | BBR property type codes: E (Andet), 1 (Egentlig beboelseslejlighed med eget køkken), 2 (Blandet bolig og erhverv med eget køkken), 3 (Enkeltværelse uden eget køkken), 4 (Fællesbolig), 5 (Sommer- eller fritidsbolig) |
unit_ |
array<integer> | BBR usage codes: 110 (Stuehus til landbrugsejendom), 120 (Fritliggende enfamiliehus), 121 (Sammenbygget enfamiliehus), 122 (Fritliggende enfamiliehus i tæt-lav bebyggelse), 131 (Række-/kæde-/klyngehus), 132 (Dobbelthus), 140 (Bolig i etageejendom/flerfamiliehus), 150 (Kollegiebolig), 160 (Bolig i døgninstitution), 185 (Anneks til helårsbolig), 190 (Anden helårsbeboelse), 211 (Stald til svin), 212 (Stald til kvæg/får), 213 (Stald til fjerkræ), 214 (Minkhal), 215 (Væksthus), 216 (Lade til foder/afgrøder), 217 (Maskinhus/garage), 218 (Lade til halm/hø), 219 (Anden landbrugsenhed), 221 (Industri med integreret produktion), 222 (Industri uden integreret produktion), 223 (Værksted), 229 (Anden produktionsenhed), 231 (Energiproduktion), 232 (Forsyningsdistribution), 233 (Vandforsyning), 234 (Affald og spildevand), 239 (Anden energienhed), 311 (Jernbane- og busdrift), 312 (Luftfart), 313 (Parkerings- og transportanlæg), 314 (Parkering til boliger), 315 (Havneanlæg), 319 (Andet transportanlæg), 321 (Kontor), 322 (Detailhandel), 323 (Lager), 324 (Butikscenter), 325 (Tankstation), 329 (Anden kontor/handel/lager), 331 (Hotel/kro/konferencecenter med overnatning), 332 (Bed & breakfast), 333 (Restaurant/café/konferencecenter), 334 (Privat servicevirksomhed), 339 (Anden serviceenhed), 411 (Biograf/teater/koncertsted), 412 (Museum), 413 (Bibliotek), 414 (Kirke/trosudøvelse), 415 (Forsamlingshus), 416 (Forlystelsespark), 419 (Anden kulturenhed), 421 (Grundskole), 422 (Universitet), 429 (Anden undervisningsenhed), 431 (Hospital og sygehus), 432 (Hospice/behandlingshjem), 433 (Sundhedscenter/lægehus/fødeklinik), 439 (Anden sundhedsenhed), 441 (Daginstitution), 442 (Servicefunktion på døgninstitution), 443 (Kaserne), 444 (Fængsel/arresthus), 449 (Anden institutionsenhed), 451 (Beskyttelsesrum), 510 (Sommerhus), 521 (Feriecenter/campingplads), 522 (Ferielejlighed til erhvervsmæssig udlejning), 523 (Ferielejlighed til eget brug), 529 (Anden ferieenhed), 531 (Klubhus/fritid og idræt), 532 (Svømmehal), 533 (Idrætshal), 534 (Tribune/stadion), 535 (Hesteopstaldning), 539 (Anden idrætsenhed), 540 (Kolonihavehus), 585 (Anneks til fritids-/sommerhus), 590 (Anden fritidsenhed) |
ownership_ |
array<integer> | Ownership state codes: 10 (Privatpersoner eller interessentskab), 20 (Alment boligselskab), 30 (Aktie-/anpart- eller andet selskab), 40 (Forening/legat/selvejende institution), 41 (Privat andelsboligforening), 50 (Beliggenhedskommune), 60 (Anden primærkommune), 70 (Region), 80 (Staten), 90 (Andet), 99 (Ikke beregnet) |
technical_ |
array<integer> | BBR technical installation codes: 1110 (Tank), 1120 (Silo), 1130 (Gasbeholder), 1140 (Affaldsbeholder), 1150 (Udskiller), 1210 (Vindmølle), 1220 (Slanger til jordvarme), 1230 (Solcelleanlæg), 1235 (Solvarmeanlæg), 1240 (Nødstrømsforsyningsanlæg), 1250 (Transformerstation), 1255 (Oliefyr), 1260 (Elskab), 1265 (Naturgasfyr), 1275 (Halmfyr), 1280 (Biogasanlæg), 1285 (Pillefyr), 1290 (Brændeovn), 1295 (Andet energianlæg), 1310 (Vandtårn), 1320 (Pumpestation), 1330 (Swimmingpool), 1340 (Privat rensningsanlæg), 1350 (Offentlige rensningsanlæg), 1360 (Regnvandsanlæg), 1905 (Legeplads), 1910 (Teknikhus), 1915 (Døgnpostboks), 1920 (Køleanlæg), 1925 (Kunstværk), 1930 (Sirene/mast med sirene), 1935 (Skilt), 1940 (Antenne/mast med antenne), 1945 (Dambrug), 1950 (Møddingsanlæg), 1955 (Andet teknisk anlæg), 1960 (Ensilageanlæg), 1965 (Planlager), 1970 (Fortidsminde/historisk ruin) |
methods_ |
array<string> | Transfer methods. |
zip_ |
integer | Zip from. 1000–9999 |
zip_ |
integer | Zip to. 1000–9999 |
purchase_ |
integer | Cash purchase amount from (usually in DKK) ≥ 0 |
purchase_ |
integer | Cash purchase amount to (usually in DKK) ≥ 0 |
property_ |
integer | Public property value from (usually in DKK) ≥ 0 |
property_ |
integer | Public property value to (usually in DKK) ≥ 0 |
land_ |
integer | Public land value from (usually in DKK) ≥ 0 |
land_ |
integer | Public land value to (usually in DKK) ≥ 0 |
acquisition_ |
string (date) | Acquisition date from. |
acquisition_ |
string (date) | Acquisition date to. |
purchase_ |
string (date) | Purchase agreement date from. |
purchase_ |
string (date) | Purchase agreement date to. |
tinglysnings_ |
string (date) | Deed date from (Premium) |
tinglysnings_ |
string (date) | Deed date to (Premium) |
loan_ |
string (date) | Last endorsement date from (Premium) |
loan_ |
string (date) | Last endorsement date to (Premium) |
plot_ |
integer | Plot area from (m2) ≥ 0 |
plot_ |
integer | Plot area to (m2) ≥ 0 |
unit_ |
integer | Residence area from (m2) ≥ 0 |
unit_ |
integer | Residence area to (m2) ≥ 0 |
unit_ |
integer | Business area from (m2) ≥ 0 |
unit_ |
integer | Business area to (m2) ≥ 0 |
number_ |
integer | Number of rooms from. 0–1000 |
number_ |
integer | Number of rooms to. 0–1000 |
number_ |
integer | Number of toilets from. 0–1000 |
number_ |
integer | Number of toilets to. 0–1000 |
number_ |
integer | Number of bathrooms from. 0–1000 |
number_ |
integer | Number of bathrooms to. 0–1000 |
technical_ |
integer | Technical installation’s establishment year from (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s establishment year to (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s decommission year from (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s decommission year to (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s reconstruction/extension year from (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s reconstruction/extension year to (Premium) 1800–2100 |
technical_ |
integer | Technical installation’s size from (liter) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s size to (liter) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s volume from (m3) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s volume to (m3) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s area from (m2) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s area to (m2) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s height from (meter) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s height to (meter) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s power from (kilowatt) (Premium) ≥ 0 |
technical_ |
integer | Technical installation’s power to (kilowatt) (Premium) ≥ 0 |
technical_ |
number | Wind turbine hub height from (meter) (Premium) ≥ 0 |
technical_ |
number | Wind turbine hub height to (meter) (Premium) ≥ 0 |
technical_ |
number | Wind turbine rotor diameter from (meter) (Premium) ≥ 0 |
technical_ |
number | Wind turbine rotor diameter to (meter) (Premium) ≥ 0 |
technical_ |
string (date) | Technical installation’s revision date from (Premium) |
technical_ |
string (date) | Technical installation’s revision date to (Premium) |
technical_ |
string (date) | Technical installation’s last inspection date from (Premium) |
technical_ |
string (date) | Technical installation’s last inspection date to (Premium) |
technical_ |
string (date) | Technical installation’s validity date from (Premium) |
technical_ |
string (date) | Technical installation’s validity date to (Premium) |
technical_ |
array<integer> | Technical installation lifecycle codes (Livscyklus) (Premium): 1 (Start), 2 (Projekteret), 3 (Under opførsel), 4 (Sagsgrund), 5 (Oprettet), 6 (Opført), 7 (Gældende), 8 (Godkendt), 9 (Afsluttet), 10 (Historisk), 11 (Fejlregistreret), 12 (Midlertidig Afsluttet), 13 (Delvis Afsluttet), 14 (Henlagt), 15 (Modtaget), 16 (UnderBehandling), 17 (Fejl), 18 (Udført), 19 (Foreløbig) |
technical_ |
array<integer> | Oil tank size class codes (Premium): 1 (Under 6.000 l), 2 (6.000 l - 100.000 l), 3 (Over 100.000 l) |
technical_ |
array<integer> | Placement codes (Premium): 0 (Ukendt), 1 (Nedgravet), 2 (Over terræn, udendørs), 3 (Indendørs) |
technical_ |
array<integer> | Oil tank decommission codes (Premium): 1 (Tanken er afblændet), 2 (Tanken er tømt og afblændet), 3 (Tanken er tømt, afblændet og opfyldt), 4 (Tanken er tømt, afblændet og påfyldningsstuds samt udluftningsrør afmonteret), 10 (Jordvarmeslangerne er sløjfet/taget ud af drift) |
technical_ |
array<integer> | Oil tank content codes (Premium): 10 (Mineralske olieprodukter), 11 (Fuelolie), 12 (Fyringsgasolie), 13 (Autogasolie/Dieselolie), 14 (Benzin), 20 (Biobrændstoffer), 30 (Affaldsprodukter), 31 (Oliebaserede affaldsprodukter/Spildolie), 40 (Gylle), 50 (Ajle/ensilagesaft/mælkerumsvand/møddingvand), 60 (Øvrige forurenende stoffer), 70 (Korn), 99 (Andet) |
technical_ |
array<integer> | Operational status codes (Driftstatus) (Premium): 1 (I drift), 2 (Ikke i drift) |
technical_ |
array<integer> | Material codes (Materiale) (Premium): 1 (Plast), 2 (Stål), 3 (Plasttank med udvendig stålvæg) |
technical_ |
string | Technical installation’s manufacturer/model (Fabrikat type) (Premium) 0–256 characters |
technical_ |
string | Technical installation’s manufacturing/serial number (Fabrikationsnummer) (Premium) 0–256 characters |
technical_ |
string | Technical installation’s type approval number from (Typegodkendelsesnummer) (Premium) 0–256 characters |
technical_ |
string | Technical installation’s type approval number to (Typegodkendelsesnummer) (Premium) 0–256 characters |
technical_ |
integer | Wind turbine number from (Vindmøllenummer) (Premium) ≥ 0 |
technical_ |
integer | Wind turbine number to (Vindmøllenummer) (Premium) ≥ 0 |
technical_ |
string | Company that inspected the technical installation (Inspicerende virksomhed) (Premium) 0–256 characters |
owner_ |
array<string> | Cross-filter: only properties with a private-person owner from these region codes. |
owner_ |
array<string> | Cross-filter: only properties with a private-person owner from these municipality codes. |
owner_ |
array<string> | Cross-filter: only properties with a private-person owner from these city names (postal district) |
owner_ |
integer | Cross-filter: owner’s zip from. 1000–9999 |
owner_ |
integer | Cross-filter: owner’s zip to. 1000–9999 |
owner_ |
integer | Cross-filter: owner’s number of companies from. ≥ 1 |
owner_ |
integer | Cross-filter: owner’s number of companies to. ≥ 1 |
owner_ |
integer | Cross-filter: owner’s number of connections from. ≥ 0 |
owner_ |
integer | Cross-filter: owner’s number of connections to. ≥ 0 |
owner_ |
integer | Cross-filter: owner’s career length (years) from. 0–99 |
owner_ |
integer | Cross-filter: owner’s career length (years) to. 0–99 |
owner_ |
integer | Cross-filter: owner’s age from (Premium) 0–99 |
owner_ |
integer | Cross-filter: owner’s age to (Premium) 0–99 |
company_ |
array<string> | Cross-filter: owner company’s region codes: capital (Region Hovedstaden), central (Region Midtjylland), north (Region Nordjylland), south (Region Syddanmark), zealand (Region Sjælland), greenland (Grønland) |
sectors[] |
array<integer> | Cross-filter: owner company’s CVR sector codes. |
company_ |
array<string> | Cross-filter: owner company’s form codes: 60 (A/S), 80 (ApS), 81 (IVS), 100 (Fund), other. |
statuses[] |
array<string> | Cross-filter: owner company’s status values — as status of companyGet gives them; the former codes without spaces (UNDERKONKURS, Aktiv, …) are still accepted. |
employees_ |
integer | Cross-filter: owner company’s number of employees from. 0–99999 |
employees_ |
integer | Cross-filter: owner company’s number of employees to. 0–99999 |
founded_ |
string (date) | Cross-filter: owner company’s founded date from. |
founded_ |
string (date) | Cross-filter: owner company’s founded date to. |
accounted_ |
string (date) | Cross-filter: owner company’s latest report date from. |
accounted_ |
string (date) | Cross-filter: owner company’s latest report date to. |
revenue_ |
integer | Cross-filter: owner company’s revenue from (t.DKK) |
revenue_ |
integer | Cross-filter: owner company’s revenue to (t.DKK) |
profit_ |
integer | Cross-filter: owner company’s profit before tax from (t.DKK) |
profit_ |
integer | Cross-filter: owner company’s profit before tax to (t.DKK) |
equity_ |
integer | Cross-filter: owner company’s equity from (t.DKK) |
equity_ |
integer | Cross-filter: owner company’s equity to (t.DKK) |
gross_ |
integer | Cross-filter: owner company’s gross profit from (t.DKK) |
gross_ |
integer | Cross-filter: owner company’s gross profit to (t.DKK) |
cash_ |
integer | Cross-filter: owner company’s liquid assets from (t.DKK) |
cash_ |
integer | Cross-filter: owner company’s liquid assets to (t.DKK) |
receivables_ |
integer | Cross-filter: owner company’s receivables from (t.DKK) |
receivables_ |
integer | Cross-filter: owner company’s receivables to (t.DKK) |
employee_ |
integer | Cross-filter: owner company’s staff expenses from (t.DKK) |
employee_ |
integer | Cross-filter: owner company’s staff expenses to (t.DKK) |
liabilities_ |
integer | Cross-filter: owner company’s debt liabilities from (t.DKK) |
liabilities_ |
integer | Cross-filter: owner company’s debt liabilities to (t.DKK) |
holding_ |
integer | Cross-filter: owner company’s holding equity from (t.DKK) |
holding_ |
integer | Cross-filter: owner company’s holding equity to (t.DKK) |
holding_ |
integer | Cross-filter: owner company’s holding profit before tax from (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding profit before tax to (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding cash from (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding cash to (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding debt from (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding debt to (t.DKK) (Insights all) |
holding_ |
integer | Cross-filter: owner company’s holding company age from (years) (Insights all) 0–99 |
holding_ |
integer | Cross-filter: owner company’s holding company age to (years) (Insights all) 0–99 |
Example
curl "https://ownr.dk/api/v2/property/segments?zip_from=7120&zip_to=7120" \ -H "Authorization: Bearer ACCESS_TOKEN"{ "status": "success", "data": { "items": [ { "item": { "id": "0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154", "slug": "property", "url": "/api/v2/property/0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154", "address_1": "Lille Strandvej 27", "address_2": "", "zip": "2900", "city": "Hellerup", "country": "DK", "restricted": [ "id", "url", "address_1", "address_2" ] }, "bfe": 3841207, "acquisition_date": "2018-04-01", "purchase_amount": 3250000, "plot_area": 820, "residence_area": 148 } ], "count": 318 }}Fields in the response
| Field | Type | Description |
|---|---|---|
data |
object | |
data. |
array<object> | |
data. |
object | |
data. |
string | e.g. 0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154 |
data. |
string | default property |
data. |
string | e.g. /api/v2/property/0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154 |
data. |
string | e.g. Lille Strandvej 27 |
data. |
string | |
data. |
string | e.g. 2900 |
data. |
string | e.g. Hellerup |
data. |
string | e.g. DK |
data. |
array<string> | Fields your plan does not include; each is null. Present only when something is hidden. |
data. |
integer | e.g. 3841207 |
data. |
string (date) | e.g. 2018-04-01 |
data. |
integer | Cash purchase amount (usually in DKK) e.g. 3250000 |
data. |
integer | Plot area (m2) e.g. 820 |
data. |
integer | Residence area (m2) e.g. 148 |
data. |
integer | The total number of matches — items is capped to the first 3 regardless of this number. e.g. 318 |
Errors
| Status | Meaning |
|---|---|
400 |
No filters supplied, a parameter the endpoint does not document, or a single-value parameter given several values |
401 |
Missing, invalid or expired access token |
403 |
The access token does not have the scope this endpoint needs |
429 |
Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded |
List purchased segments
GET /segments/downloadsScope: companies or persons or properties · Quota: does not count against the quota
Lists the account’s purchased segment downloads (see the person/company/property segments endpoints to find and buy one). Use segments/downloads/{id} to read one in full.
Parameters
| Parameter | Type | Description |
|---|---|---|
page |
integer | Page number. default 1 |
Example
curl "https://ownr.dk/api/v2/segments/downloads" \ -H "Authorization: Bearer ACCESS_TOKEN"{ "status": "success", "data": { "items": [ { "id": 42, "type": "property", "title": "Segment d. 12.03.2026 14:20:00", "size": 318, "is_paid": true, "is_watched": false, "created": "2026-01-31T12:00:00+01:00", "expires": "2026-01-31T12:00:00+01:00", "url": "https://ownr.dk/api/v2/segments/downloads/42" } ], "count": 6, "page": 1, "pageCount": 1, "nextPageUrl": null, "prevPageUrl": null }}Fields in the response
| Field | Type | Description |
|---|---|---|
data |
object | |
data. |
array<object> | |
data. |
integer | e.g. 42 |
data. |
string | company, person, property · e.g. property |
data. |
string | e.g. Segment d. 12.03.2026 14:20:00 |
data. |
integer | Number of entities matching the filters now. A watched segment keeps the rows of entities that left it, with afgangsdato set, so the rows of the download can outnumber it. e.g. 318 |
data. |
boolean | e.g. true |
data. |
boolean | Whether the segment is a monitored subscription that keeps adding new matches. e.g. false |
data. |
string (date-time) | |
data. |
string (date-time) | Until when the rows can be read, after that GET /segments/downloads/{id} answers 404 and the download is deleted. An unpaid download expires 30 days after it was made; a paid one 3 years after it was paid, or, when it was monitored, 3 years after its subscription ended. A monitored download stops receiving new matches once its subscription ends. |
data. |
string | e.g. https://ownr.dk/api/v2/segments/downloads/42 |
data. |
integer | The total number of records in the result set. e.g. 6 |
data. |
integer | The current page displayed. e.g. 1 |
data. |
integer | Total number of pages. e.g. 1 |
data. |
string | |
data. |
string |
Errors
| Status | Meaning |
|---|---|
401 |
Missing, invalid or expired access token |
403 |
The access token does not have the scope this endpoint needs |
429 |
Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded |
Get one purchased segment, with its matched entities
GET /segments/downloads/{id}Scope: companies or persons or properties · Quota: does not count against the quota
Parameters
| Parameter | Type | Description |
|---|---|---|
idin path, required |
integer | |
page |
integer | Page number. default 1 |
Example
curl "https://ownr.dk/api/v2/segments/downloads/42" \ -H "Authorization: Bearer ACCESS_TOKEN"Show example response
{ "status": "success", "data": { "id": 42, "type": "property", "title": "Segment d. 12.03.2026 14:20:00", "size": 318, "is_paid": true, "is_watched": false, "created": "2026-01-31T12:00:00+01:00", "expires": "2026-01-31T12:00:00+01:00", "url": "https://ownr.dk/api/v2/segments/downloads/42", "items": [ { "entity_key": "10403782", "cvr": 10403782, "name": "LEGO A/S", "rating": 0, "status": "Normal", "company_type": "Aktieselskab", "founded": null, "employees_number": "1000 - 999999", "sector": null, "district": null, "address": null, "zip": "7190", "city": null, "result_before_tax": 1500000, "result_before_tax_unit": "DKK", "equity": 8200000, "equity_unit": "DKK", "gross_profit": 3100000, "gross_profit_unit": "DKK", "phone": null, "email": null, "url": null, "google": null, "ownr_link": null, "tilgangsdato": null, "afgangsdato": null } ], "count": 318, "page": 1, "pageCount": 13, "nextPageUrl": null, "prevPageUrl": null }}Fields in the response
Show all 42 fields
| Field | Type | Description |
|---|---|---|
data |
object | |
data. |
integer | e.g. 42 |
data. |
string | company, person, property · e.g. property |
data. |
string | e.g. Segment d. 12.03.2026 14:20:00 |
data. |
integer | Number of entities matching the filters now. A watched segment keeps the rows of entities that left it, with afgangsdato set, so the rows of the download can outnumber it. e.g. 318 |
data. |
boolean | e.g. true |
data. |
boolean | e.g. false |
data. |
string (date-time) | |
data. |
string (date-time) | Until when the rows can be read, after that GET /segments/downloads/{id} answers 404 and the download is deleted. An unpaid download expires 30 days after it was made; a paid one 3 years after it was paid, or, when it was monitored, 3 years after its subscription ended. A monitored download stops receiving new matches once its subscription ends. |
data. |
string | e.g. https://ownr.dk/api/v2/segments/downloads/42 |
data. |
array<object> | The rows of the download, one key/value object per row — the same columns the CSV/XLSX export carries, typed: dates as YYYY-MM-DD, amounts as integers with their unit in {column}_unit (e.g. purchase_price 5750000 and purchase_price_unit DKK; a unit starting with ' is in thousands, as unit of a report), counts and ids as integers, zip as a string, a missing value as null. A value the user edited in the segment and that does not parse is returned as typed. tilgangsdato is when the entity entered the segment, afgangsdato when it left it (null while it still matches) |
data. |
string | e.g. 10403782 |
data. |
integer | e.g. 10403782 |
data. |
string | e.g. LEGO A/S |
data. |
integer | e.g. 0 |
data. |
string | e.g. Normal |
data. |
string | e.g. Aktieselskab |
data. |
string (date) | |
data. |
string | An interval, or an integer when the number is exact. e.g. 1000 - 999999 |
data. |
string | |
data. |
string | |
data. |
string | |
data. |
string | e.g. 7190 |
data. |
string | |
data. |
integer | e.g. 1500000 |
data. |
string | Unit of the amount. One starting with ' is in thousands. e.g. DKK |
data. |
integer | e.g. 8200000 |
data. |
string | Unit of the amount. One starting with ' is in thousands. e.g. DKK |
data. |
integer | e.g. 3100000 |
data. |
string | Unit of the amount. One starting with ' is in thousands. e.g. DKK |
data. |
string | |
data. |
string | |
data. |
string | |
data. |
string | |
data. |
string | |
data. |
string (date) | When the entity entered the segment. |
data. |
string (date) | When it left the segment, null while it still matches. |
data. |
integer | The total number of rows, those that left the segment included. e.g. 318 |
data. |
integer | The current page displayed. e.g. 1 |
data. |
integer | Total number of pages. e.g. 13 |
data. |
string | |
data. |
string |
Errors
| Status | Meaning |
|---|---|
400 |
Invalid ID supplied |
401 |
Missing, invalid or expired access token |
402 |
Segment not paid yet |
403 |
The access token does not have the scope this endpoint needs |
404 |
Segment not found, or expired (see expires) |
429 |
Call quota or hourly rate limit reached. Retry-After gives the seconds to wait; when the quota is used up, error.upgrade_url links to where the tier is upgraded |