Screening

/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):

    MetricActive 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.

post/v1/screen

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

cursorstring nullable

Opaque pagination cursor from a previous response's meta.next_cursor. Filters and sort must be unchanged between pages.

limitinteger

Results per page (1-100)

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.