Skip to content

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/segments

Scope: 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_active string Only active business persons. 0, 1
is_inactive string Only inactive business persons. 0, 1
is_not_address_protected string Exclude address-protected persons. 0, 1
has_holding string Only persons who own a holding company. 0, 1
has_property 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_regions[] 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_types[] array<string> Company form codes: 60 (A/S), 80 (ApS), 81 (IVS), 100 (Fund), other.
zip_from integer Zip code from. 1000–9999
zip_to integer Zip code to. 1000–9999
companies_count_from integer Number of companies from. 1–100
companies_count_to integer Number of companies to. 1–100
connections_count_from integer Number of connections from. 0–9999
connections_count_to integer Number of connections to. 0–9999
carrier_started_from integer Career length from (years) 0–99
carrier_started_to integer Career length to (years) 0–99
revenue_from integer Revenue from (t.DKK)
revenue_to integer Revenue to (t.DKK)
profit_before_tax_from integer Profit before tax from (t.DKK)
profit_before_tax_to integer Profit before tax to (t.DKK)
equity_from integer Equity from (t.DKK)
equity_to integer Equity to (t.DKK)
holding_equity_from integer Holding equity from (t.DKK)
holding_equity_to integer Holding equity to (t.DKK)
holding_profit_before_tax_from integer Holding profit before tax from (t.DKK) (Insights all)
holding_profit_before_tax_to integer Holding profit before tax to (t.DKK) (Insights all)
holding_cash_from integer Holding cash from (t.DKK) (Insights all)
holding_cash_to integer Holding cash to (t.DKK) (Insights all)
holding_debt_from integer Holding debt from (t.DKK) (Insights all)
holding_debt_to integer Holding debt to (t.DKK) (Insights all)
holding_age_from integer Holding company age from (years) (Insights all) 0–99
holding_age_to integer Holding company age to (years) (Insights all) 0–99
age_from integer Person age from (years) (Premium) 0–99
age_to integer Person age to (years) (Premium) 0–99
properties_count_from integer Number of owned properties from. 0–999
properties_count_to 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_from integer Number of employees from. 0–99999
employees_to integer Number of employees to. 0–99999
founded_from string (date) Company founded date from.
founded_to string (date) Company founded date to.
accounted_from string (date) Latest report date from.
accounted_to string (date) Latest report date to.
gross_profit_from integer Gross profit from (t.DKK)
gross_profit_to integer Gross profit to (t.DKK)
cash_from integer Liquid assets from (t.DKK)
cash_to integer Liquid assets to (t.DKK)
receivables_from integer Receivables from (t.DKK)
receivables_to integer Receivables to (t.DKK)
employee_benefits_from integer Staff expenses from (t.DKK)
employee_benefits_to integer Staff expenses to (t.DKK)
liabilities_from integer Debt liabilities from (t.DKK)
liabilities_to integer Debt liabilities to (t.DKK)
property_types[] array<string> Property types: matrikuleret_areal (SFE), ejerlejlighed (apartment), bpfg (bygning paa fremmed grund)
property_cities[] array<string> Property city names.
property_unit_types[] 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_unit_usages[] 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_zip_from integer Property zip from. 1000–9999
property_zip_to integer Property zip to. 1000–9999
property_plot_area_from integer Plot area from (m2) ≥ 0
property_plot_area_to integer Plot area to (m2) ≥ 0
property_residence_area_from integer Residence area from (m2) ≥ 0
property_residence_area_to integer Residence area to (m2) ≥ 0
property_purchase_price_from integer Purchase price from (usually in DKK) ≥ 0
property_purchase_price_to integer Purchase price to (usually in DKK) ≥ 0
property_acquisition_date_from string (date) Acquisition date from.
property_acquisition_date_to string (date) Acquisition date to.
property_tinglysnings_date_from string (date) Deed date from (Premium)
property_tinglysnings_date_to string (date) Deed date to (Premium)
property_loan_update_date_from string (date) Last endorsement date from (Premium)
property_loan_update_date_to string (date) Last endorsement date to (Premium)
property_regions[] array<string> Property region codes: capital, central, north, south, zealand.
property_districts[] array<string> Property municipality codes.
property_methods_of_transfer[] array<string> Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel særlige vilkår.
property_ownership_states[] 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_business_area_from integer Property business area from (m2) ≥ 0
property_business_area_to integer Property business area to (m2) ≥ 0
property_rooms_from integer Property number of rooms from. 0–1000
property_rooms_to integer Property number of rooms to. 0–1000
property_toilets_from integer Property number of toilets from. 0–1000
property_toilets_to integer Property number of toilets to. 0–1000
property_bathrooms_from integer Property number of bathrooms from. 0–1000
property_bathrooms_to integer Property number of bathrooms to. 0–1000

Example

Terminal window
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.items array<object>
data.items[].item object
data.items[].item.id integer e.g. 4004068725
data.items[].item.slug string default person
data.items[].item.url string e.g. /api/v2/person/4004068725
data.items[].item.name string e.g. Jesper Buch
data.items[].is_active boolean e.g. true
data.items[].birthday string (date) e.g. 1975-03-14
data.items[].companies_count integer e.g. 3
data.items[].connections_count integer e.g. 12
data.items[].zip string e.g. 2100
data.items[].city string Locality of the address, empty when the address has none. e.g. Kobenhavn O
data.items[].postal_district string City of the zip code. e.g. København Ø
data.count 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/segments

Scope: 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_inactive string Only inactive companies. 0, 1
has_contacts 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_protected 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_from integer Zip code from. 1000–9999
zip_to integer Zip code to. 1000–9999
age_from integer Company age from (years) (Premium) 0–200
age_to integer Company age to (years) (Premium) 0–200
employees_from integer Number of employees from. ≥ 0
employees_to integer Number of employees to. ≥ 0
founded_from string (date) Founded date from.
founded_to string (date) Founded date to.
ceased_from string (date) Ceased date from.
ceased_to string (date) Ceased date to.
accounted_from string (date) Latest report date from.
accounted_to string (date) Latest report date to.
properties_count_from integer Number of owned properties from (Premium) 0–999
properties_count_to integer Number of owned properties to (Premium) 0–999
ProfitLossBeforeTax_from integer Profit before tax from (t.DKK)
ProfitLossBeforeTax_to integer Profit before tax to (t.DKK)
Equity_from integer Equity from (t.DKK)
Equity_to integer Equity to (t.DKK)
GrossProfit_from integer Gross profit from (t.DKK)
GrossProfit_to integer Gross profit to (t.DKK)
CashAndCashEquivalents_from integer Liquid assets from (t.DKK)
CashAndCashEquivalents_to integer Liquid assets to (t.DKK)
ShorttermReceivables_from integer Receivables from (t.DKK)
ShorttermReceivables_to integer Receivables to (t.DKK)
ShorttermInvestments_from integer Short term investments from (t.DKK)
ShorttermInvestments_to integer Short term investments to (t.DKK)
EmployeeBenefitsExpense_from integer Staff expenses from (t.DKK)
EmployeeBenefitsExpense_to integer Staff expenses to (t.DKK)
LiabilitiesOtherThanProvisions_from integer Debt liabilities from (t.DKK)
LiabilitiesOtherThanProvisions_to integer Debt liabilities to (t.DKK)
property_cities[] array<string> Property city names.
property_regions[] array<string> Property region codes: capital, central, north, south, zealand.
property_districts[] array<string> Property municipality codes.
property_zip_from integer Property zip from. 1000–9999
property_zip_to integer Property zip to. 1000–9999
property_unit_types[] 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_unit_usages[] array<integer> BBR unit usage codes.
property_methods_of_transfer[] array<string> Property transfer methods: Almindelig fri handel, Anden overdragelse, Familieoverdragelse, Interessesammenfald, Mageskifte, Almindelig fri handel særlige vilkår.
property_ownership_states[] 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_purchase_price_from integer Property purchase price from (usually in DKK) ≥ 0
property_purchase_price_to integer Property purchase price to (usually in DKK) ≥ 0
property_acquisition_date_from string (date) Property acquisition date from.
property_acquisition_date_to string (date) Property acquisition date to.
property_tinglysnings_date_from string (date) Property deed date from (Premium)
property_tinglysnings_date_to string (date) Property deed date to (Premium)
property_loan_update_date_from string (date) Property last endorsement date from (Premium)
property_loan_update_date_to string (date) Property last endorsement date to (Premium)
property_plot_area_from integer Property plot area from (m2) ≥ 0
property_plot_area_to integer Property plot area to (m2) ≥ 0
property_residence_area_from integer Property residence area from (m2) ≥ 0
property_residence_area_to integer Property residence area to (m2) ≥ 0
property_business_area_from integer Property business area from (m2) ≥ 0
property_business_area_to integer Property business area to (m2) ≥ 0
property_rooms_from integer Property number of rooms from. 0–1000
property_rooms_to integer Property number of rooms to. 0–1000
property_toilets_from integer Property number of toilets from. 0–1000
property_toilets_to integer Property number of toilets to. 0–1000
property_bathrooms_from integer Property number of bathrooms from. 0–1000
property_bathrooms_to integer Property number of bathrooms to. 0–1000
person_regions[] array<string> Cross-filter: only companies with a related person from these region codes.
person_districts[] array<string> Cross-filter: related person’s municipality codes.
person_cities[] array<string> Cross-filter: related person’s city names.
person_zip_from integer Cross-filter: related person’s zip from. 1000–9999
person_zip_to integer Cross-filter: related person’s zip to. 1000–9999
person_companies_count_from integer Cross-filter: related person’s number of companies from. ≥ 1
person_companies_count_to integer Cross-filter: related person’s number of companies to. ≥ 1
person_connections_count_from integer Cross-filter: related person’s number of connections from. ≥ 0
person_connections_count_to integer Cross-filter: related person’s number of connections to. ≥ 0
person_carrier_started_from integer Cross-filter: related person’s career length from (years) 0–99
person_carrier_started_to integer Cross-filter: related person’s career length to (years) 0–99
person_age_from integer Cross-filter: related person’s age from (Premium) 0–99
person_age_to integer Cross-filter: related person’s age to (Premium) 0–99

Example

Terminal window
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.items array<object>
data.items[].item object
data.items[].item.id integer e.g. 36732261
data.items[].item.slug string default company
data.items[].item.url string e.g. /api/v2/company/36732261
data.items[].item.name string e.g. SNT ApS
data.items[].status string e.g. AKTIV
data.items[].founded string (date) e.g. 2010-06-15
data.items[].ceased string (date)
data.items[].employees_number integer e.g. 12
data.items[].zip string e.g. 1620
data.items[].city string e.g. Kobenhavn V
data.items[].sector object
data.items[].sector.code integer e.g. 620100
data.items[].sector.text string e.g. Udvikling og produktion af software
data.count 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/segments

Scope: 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_is_private_person string Only properties owned by a private person. 0, 1
owner_is_company string Only properties owned by a company. 0, 1
has_bfe 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_property_types[] 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_usages[] 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_states[] 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_installation_classifications[] 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_of_transfer[] array<string> Transfer methods.
zip_from integer Zip from. 1000–9999
zip_to integer Zip to. 1000–9999
purchase_amount_from integer Cash purchase amount from (usually in DKK) ≥ 0
purchase_amount_to integer Cash purchase amount to (usually in DKK) ≥ 0
property_value_from integer Public property value from (usually in DKK) ≥ 0
property_value_to integer Public property value to (usually in DKK) ≥ 0
land_value_from integer Public land value from (usually in DKK) ≥ 0
land_value_to integer Public land value to (usually in DKK) ≥ 0
acquisition_date_from string (date) Acquisition date from.
acquisition_date_to string (date) Acquisition date to.
purchase_agreement_date_from string (date) Purchase agreement date from.
purchase_agreement_date_to string (date) Purchase agreement date to.
tinglysnings_date_from string (date) Deed date from (Premium)
tinglysnings_date_to string (date) Deed date to (Premium)
loan_update_date_from string (date) Last endorsement date from (Premium)
loan_update_date_to string (date) Last endorsement date to (Premium)
plot_registered_area_from integer Plot area from (m2) ≥ 0
plot_registered_area_to integer Plot area to (m2) ≥ 0
unit_area_for_residence_from integer Residence area from (m2) ≥ 0
unit_area_for_residence_to integer Residence area to (m2) ≥ 0
unit_area_for_business_from integer Business area from (m2) ≥ 0
unit_area_for_business_to integer Business area to (m2) ≥ 0
number_of_rooms_from integer Number of rooms from. 0–1000
number_of_rooms_to integer Number of rooms to. 0–1000
number_of_toilets_from integer Number of toilets from. 0–1000
number_of_toilets_to integer Number of toilets to. 0–1000
number_of_bathrooms_from integer Number of bathrooms from. 0–1000
number_of_bathrooms_to integer Number of bathrooms to. 0–1000
technical_installation_year_from integer Technical installation’s establishment year from (Premium) 1800–2100
technical_installation_year_to integer Technical installation’s establishment year to (Premium) 1800–2100
technical_installation_decommission_year_from integer Technical installation’s decommission year from (Premium) 1800–2100
technical_installation_decommission_year_to integer Technical installation’s decommission year to (Premium) 1800–2100
technical_installation_reconstruction_year_from integer Technical installation’s reconstruction/extension year from (Premium) 1800–2100
technical_installation_reconstruction_year_to integer Technical installation’s reconstruction/extension year to (Premium) 1800–2100
technical_installation_size_from integer Technical installation’s size from (liter) (Premium) ≥ 0
technical_installation_size_to integer Technical installation’s size to (liter) (Premium) ≥ 0
technical_installation_volume_from integer Technical installation’s volume from (m3) (Premium) ≥ 0
technical_installation_volume_to integer Technical installation’s volume to (m3) (Premium) ≥ 0
technical_installation_area_from integer Technical installation’s area from (m2) (Premium) ≥ 0
technical_installation_area_to integer Technical installation’s area to (m2) (Premium) ≥ 0
technical_installation_height_from integer Technical installation’s height from (meter) (Premium) ≥ 0
technical_installation_height_to integer Technical installation’s height to (meter) (Premium) ≥ 0
technical_installation_power_from integer Technical installation’s power from (kilowatt) (Premium) ≥ 0
technical_installation_power_to integer Technical installation’s power to (kilowatt) (Premium) ≥ 0
technical_installation_hub_height_from number Wind turbine hub height from (meter) (Premium) ≥ 0
technical_installation_hub_height_to number Wind turbine hub height to (meter) (Premium) ≥ 0
technical_installation_rotor_diameter_from number Wind turbine rotor diameter from (meter) (Premium) ≥ 0
technical_installation_rotor_diameter_to number Wind turbine rotor diameter to (meter) (Premium) ≥ 0
technical_installation_revision_date_from string (date) Technical installation’s revision date from (Premium)
technical_installation_revision_date_to string (date) Technical installation’s revision date to (Premium)
technical_installation_last_inspection_date_from string (date) Technical installation’s last inspection date from (Premium)
technical_installation_last_inspection_date_to string (date) Technical installation’s last inspection date to (Premium)
technical_installation_validity_date_from string (date) Technical installation’s validity date from (Premium)
technical_installation_validity_date_to string (date) Technical installation’s validity date to (Premium)
technical_installation_statuses[] 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_installation_size_classes[] 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_installation_placements[] array<integer> Placement codes (Premium): 0 (Ukendt), 1 (Nedgravet), 2 (Over terræn, udendørs), 3 (Indendørs)
technical_installation_decommission_types[] 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_installation_oil_tank_contents[] 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_installation_operation_statuses[] array<integer> Operational status codes (Driftstatus) (Premium): 1 (I drift), 2 (Ikke i drift)
technical_installation_materials[] array<integer> Material codes (Materiale) (Premium): 1 (Plast), 2 (Stål), 3 (Plasttank med udvendig stålvæg)
technical_installation_fabrication_type string Technical installation’s manufacturer/model (Fabrikat type) (Premium) 0–256 characters
technical_installation_fabrication_number string Technical installation’s manufacturing/serial number (Fabrikationsnummer) (Premium) 0–256 characters
technical_installation_type_approval_number_from string Technical installation’s type approval number from (Typegodkendelsesnummer) (Premium) 0–256 characters
technical_installation_type_approval_number_to string Technical installation’s type approval number to (Typegodkendelsesnummer) (Premium) 0–256 characters
technical_installation_wind_turbine_number_from integer Wind turbine number from (Vindmøllenummer) (Premium) ≥ 0
technical_installation_wind_turbine_number_to integer Wind turbine number to (Vindmøllenummer) (Premium) ≥ 0
technical_installation_inspecting_company string Company that inspected the technical installation (Inspicerende virksomhed) (Premium) 0–256 characters
owner_person_regions[] array<string> Cross-filter: only properties with a private-person owner from these region codes.
owner_person_districts[] array<string> Cross-filter: only properties with a private-person owner from these municipality codes.
owner_person_cities[] array<string> Cross-filter: only properties with a private-person owner from these city names (postal district)
owner_person_zip_from integer Cross-filter: owner’s zip from. 1000–9999
owner_person_zip_to integer Cross-filter: owner’s zip to. 1000–9999
owner_person_companies_count_from integer Cross-filter: owner’s number of companies from. ≥ 1
owner_person_companies_count_to integer Cross-filter: owner’s number of companies to. ≥ 1
owner_person_connections_count_from integer Cross-filter: owner’s number of connections from. ≥ 0
owner_person_connections_count_to integer Cross-filter: owner’s number of connections to. ≥ 0
owner_person_carrier_started_from integer Cross-filter: owner’s career length (years) from. 0–99
owner_person_carrier_started_to integer Cross-filter: owner’s career length (years) to. 0–99
owner_person_age_from integer Cross-filter: owner’s age from (Premium) 0–99
owner_person_age_to integer Cross-filter: owner’s age to (Premium) 0–99
company_regions[] 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_types[] 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_from integer Cross-filter: owner company’s number of employees from. 0–99999
employees_to integer Cross-filter: owner company’s number of employees to. 0–99999
founded_from string (date) Cross-filter: owner company’s founded date from.
founded_to string (date) Cross-filter: owner company’s founded date to.
accounted_from string (date) Cross-filter: owner company’s latest report date from.
accounted_to string (date) Cross-filter: owner company’s latest report date to.
revenue_from integer Cross-filter: owner company’s revenue from (t.DKK)
revenue_to integer Cross-filter: owner company’s revenue to (t.DKK)
profit_before_tax_from integer Cross-filter: owner company’s profit before tax from (t.DKK)
profit_before_tax_to integer Cross-filter: owner company’s profit before tax to (t.DKK)
equity_from integer Cross-filter: owner company’s equity from (t.DKK)
equity_to integer Cross-filter: owner company’s equity to (t.DKK)
gross_profit_from integer Cross-filter: owner company’s gross profit from (t.DKK)
gross_profit_to integer Cross-filter: owner company’s gross profit to (t.DKK)
cash_from integer Cross-filter: owner company’s liquid assets from (t.DKK)
cash_to integer Cross-filter: owner company’s liquid assets to (t.DKK)
receivables_from integer Cross-filter: owner company’s receivables from (t.DKK)
receivables_to integer Cross-filter: owner company’s receivables to (t.DKK)
employee_benefits_from integer Cross-filter: owner company’s staff expenses from (t.DKK)
employee_benefits_to integer Cross-filter: owner company’s staff expenses to (t.DKK)
liabilities_from integer Cross-filter: owner company’s debt liabilities from (t.DKK)
liabilities_to integer Cross-filter: owner company’s debt liabilities to (t.DKK)
holding_equity_from integer Cross-filter: owner company’s holding equity from (t.DKK)
holding_equity_to integer Cross-filter: owner company’s holding equity to (t.DKK)
holding_profit_before_tax_from integer Cross-filter: owner company’s holding profit before tax from (t.DKK) (Insights all)
holding_profit_before_tax_to integer Cross-filter: owner company’s holding profit before tax to (t.DKK) (Insights all)
holding_cash_from integer Cross-filter: owner company’s holding cash from (t.DKK) (Insights all)
holding_cash_to integer Cross-filter: owner company’s holding cash to (t.DKK) (Insights all)
holding_debt_from integer Cross-filter: owner company’s holding debt from (t.DKK) (Insights all)
holding_debt_to integer Cross-filter: owner company’s holding debt to (t.DKK) (Insights all)
holding_age_from integer Cross-filter: owner company’s holding company age from (years) (Insights all) 0–99
holding_age_to integer Cross-filter: owner company’s holding company age to (years) (Insights all) 0–99

Example

Terminal window
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.items array<object>
data.items[].item object
data.items[].item.id string e.g. 0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154
data.items[].item.slug string default property
data.items[].item.url string e.g. /api/v2/property/0a3f507b-efd8-32b8-e044-0003ba298018_0000002009154
data.items[].item.address_1 string e.g. Lille Strandvej 27
data.items[].item.address_2 string
data.items[].item.zip string e.g. 2900
data.items[].item.city string e.g. Hellerup
data.items[].item.country string e.g. DK
data.items[].item.restricted array<string> Fields your plan does not include; each is null. Present only when something is hidden.
data.items[].bfe integer e.g. 3841207
data.items[].acquisition_date string (date) e.g. 2018-04-01
data.items[].purchase_amount integer Cash purchase amount (usually in DKK) e.g. 3250000
data.items[].plot_area integer Plot area (m2) e.g. 820
data.items[].residence_area integer Residence area (m2) e.g. 148
data.count 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/downloads

Scope: 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

Terminal window
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.items array<object>
data.items[].id integer e.g. 42
data.items[].type string company, person, property · e.g. property
data.items[].title string e.g. Segment d. 12.03.2026 14:20:00
data.items[].size 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.items[].is_paid boolean e.g. true
data.items[].is_watched boolean Whether the segment is a monitored subscription that keeps adding new matches. e.g. false
data.items[].created string (date-time)
data.items[].expires 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.items[].url string e.g. https://ownr.dk/api/v2/segments/downloads/42
data.count integer The total number of records in the result set. e.g. 6
data.page integer The current page displayed. e.g. 1
data.pageCount integer Total number of pages. e.g. 1
data.nextPageUrl string
data.prevPageUrl 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
id
in path, required
integer
page integer Page number. default 1

Example

Terminal window
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.id integer e.g. 42
data.type string company, person, property · e.g. property
data.title string e.g. Segment d. 12.03.2026 14:20:00
data.size 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.is_paid boolean e.g. true
data.is_watched boolean e.g. false
data.created string (date-time)
data.expires 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.url string e.g. https://ownr.dk/api/v2/segments/downloads/42
data.items 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.items[].entity_key string e.g. 10403782
data.items[].cvr integer e.g. 10403782
data.items[].name string e.g. LEGO A/S
data.items[].rating integer e.g. 0
data.items[].status string e.g. Normal
data.items[].company_type string e.g. Aktieselskab
data.items[].founded string (date)
data.items[].employees_number string An interval, or an integer when the number is exact. e.g. 1000 - 999999
data.items[].sector string
data.items[].district string
data.items[].address string
data.items[].zip string e.g. 7190
data.items[].city string
data.items[].result_before_tax integer e.g. 1500000
data.items[].result_before_tax_unit string Unit of the amount. One starting with ' is in thousands. e.g. DKK
data.items[].equity integer e.g. 8200000
data.items[].equity_unit string Unit of the amount. One starting with ' is in thousands. e.g. DKK
data.items[].gross_profit integer e.g. 3100000
data.items[].gross_profit_unit string Unit of the amount. One starting with ' is in thousands. e.g. DKK
data.items[].phone string
data.items[].email string
data.items[].url string
data.items[].google string
data.items[].ownr_link string
data.items[].tilgangsdato string (date) When the entity entered the segment.
data.items[].afgangsdato string (date) When it left the segment, null while it still matches.
data.count integer The total number of rows, those that left the segment included. e.g. 318
data.page integer The current page displayed. e.g. 1
data.pageCount integer Total number of pages. e.g. 13
data.nextPageUrl string
data.prevPageUrl 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