internal

Estimate Report

Estimate the number of companies matching the given filters.

Accepts either the legacy flat ReportFilters shape or the new-style {"screen": {...}, "list_ids": [], "connection_ids": []} shape that exposes every /v1/screen filter.

When include_preview=true, the response also includes a sample of matching companies (capped at 50). The HTML UI never sets this — it's used by the MCP preview_lead_list tool to give agents a concrete view before the user commits to a full Pro-tier export.

Below Pro (companydata.dk only): a logged-out visitor gets the count, a Basic account the count and, with include_preview, the first 5 companies, both within the daily allowances in services/preview_limits.py.

post/v1/report-requests/estimate

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/report-requests/estimate
  • Auth: HTTP bearer

Query parameters

include_previewboolean
preview_limitinteger

Request body

OR

Response

Successful Response

estimated_countinteger required

Estimated number of companies matching filters

previewobject[] nullable

Sample of matching companies. Only populated when include_preview=true is requested (the MCP preview_lead_list tool, and the free preview on companydata.dk, which shows a Basic account the first 5).

preview_withheldstring nullable

Why a requested preview is empty below Pro: pro_filters (the filters use Pro-only criteria) or daily_limit (the day's previews are used).

Changes

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