Filter companies (portfolio / market sizing)
advanced_searchRead-onlyIdempotent
Structured company search for portfolio building and market sizing — NOT for finding one known company (use search_companies). Filters: country, NACE prefix, status, region, turnover range (EUR), employee range, founding date range, VAT payer, tax debt, sanctions. Results are paged (limit + offset); the response says how many matched. Only the listed arguments exist — anything else is rejected, never silently ignored.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nace | No | NACE code prefix, e.g. '62' (IT services) or '6201'. | |
| limit | No | Page size (default 50). | |
| order | No | Sort order (default turnover_desc). | |
| offset | No | Rows to skip for the next page. | |
| region | No | Region name exactly as the register spells it. | |
| status | No | Company lifecycle status. | |
| country | No | ISO 3166-1 alpha-2 country of the register (e.g. SK, CZ, AT, PL). Strongly recommended: registry numbers are NOT unique across countries (an SK and a CZ company can share the same 8-digit IČO), and without it the server picks one by tie-break. | |
| tax_debt | No | Only companies on (true) / off (false) the tax-debtor list. | |
| vat_payer | No | Only VAT-registered (true) or only non-registered (false). | |
| founded_to | No | Founded on or before (YYYY-MM-DD). | |
| sanctioned | No | Only companies with (true) / without (false) a sanctions hit. | |
| founded_from | No | Founded on or after (YYYY-MM-DD). | |
| employees_max | No | Maximum number of employees. | |
| employees_min | No | Minimum number of employees. | |
| turnover_max_eur | No | Maximum latest annual turnover in EUR. | |
| turnover_min_eur | No | Minimum latest annual turnover in EUR. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Matching companies for this page, plus total count and any unknownFilters. | |
| meta | No | Request metadata: request_id (quote it in support requests), duration_ms, cached. |