/screen
Screen the company register on structured criteria: industry, geography, company type, size and financial key figures from the latest annual report. All given filters are combined with AND; results are paginated with an opaque cursor.
Example: companies in Region Midtjylland with an equity ratio below 15% and at least 5 employees:
{
"filters": {
"region_codes": ["1082"],
"employees": {"min": 5},
"financials": {"equity_ratio": {"max": 0.15}}
},
"sort": {"field": "equity_ratio", "direction": "asc"},
"limit": 50
}
Data notes:
-
Financial criteria use the company's most recent annual report. Most small companies (reporting class B) do not publish revenue, only gross profit; filtering on revenue therefore excludes them. Each result includes financials.reporting_class and financials.period_end so you can judge coverage and freshness.
-
Metric coverage (active companies with the metric, August 2026 — about 41% of the ~860,000 active companies file annual reports at all; the rest are mainly sole proprietorships with no filing duty):
Metric Active companies profit_loss, equity, total_assets ~353,000 (41%) equity_ratio ~348,000 (40%) gross_profit ~338,000 (39%) current_ratio ~329,000 (38%) return_on_equity ~299,000 (35%) operating_profit ~278,000 (32%) employees ~257,000 (30%) revenue ~24,000 (2.7%) For "small companies" screens, gross_profit and employees reach the broad register; revenue reaches only the minority obliged to disclose it (reporting classes C/D).
-
Amounts are DKK. Ratios are fractions: equity_ratio 0.15 means a soliditetsgrad of 15%. Figures are as filed; occasional filing errors can produce extreme ratio values.
-
A company only matches a financial filter if its latest report contains that metric. Sorting by a metric likewise only returns companies where the metric is present.
-
Growth metrics (revenue_growth, gross_profit_growth, equity_growth) are year-over-year fractions computed from the report's own comparative figures: -0.2 means a 20% decline. Absent when the base year is missing or zero.
-
cds_score (0-100) and cds_ratings filter on the CDS (CompanyData Score). Only companies with a computed score match these filters.
-
Each result carries location (lat/lng, WGS84) for the registered address, so a result set can be plotted or trimmed by area without a second lookup. It is absent when the address could not be geocoded or is withheld.
Use POST /v1/screen/count with the same filters to size a segment before pulling pages.
Request
- Base URL: https://api.companydata.dk (the document declares no server; this is the origin it was published from)
- URL: https://api.companydata.dk/v1/screen
- Auth: HTTP bearer
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 2 revisions of this API.