Advanced company search
advanced_searchSearch companies using filters for registry, geography, financials, credit, sanctions, cyber, tech, and public funds, with pagination and country breakdowns.
Instructions
Structured multi-filter company search across registry, geography, sector, size, financials, credit/distress, sanctions, NIS2 and cyber exposure, digital footprint (including tech= for a named technology such as PrestaShop or CookieYes) and public money. Returns a paginated list with a per-country breakdown. Totals are capped at 5000 — pagination.isCapped says when the real number is higher. Check data.unknownFilters in the response: any key listed there was DROPPED, so the result is wider than you asked for. Use for analyst-style queries like 'active SK e-shops on PrestaShop with turnover over €1M and no consent platform detected'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nace | No | Single NACE prefix match, e.g. '46' | |
| tech | No | Named technology, exact match, e.g. 'PrestaShop', 'Shoptet', 'CookieYes'. An unknown name returns 400 with the full list in meta.available — ask for a wrong one once to discover what is detectable. | |
| year | No | Financial year for period-specific figures | |
| limit | No | Max results (default 50, cap 200) | |
| nuts2 | No | NUTS-2 code | |
| nuts3 | No | NUTS-3 code, e.g. 'SK042' | |
| order | No | NOT 'sort'. An unrecognised value falls back to turnover_desc silently. | |
| active | No | Registry active flag (NOT is_active) | |
| offset | No | Pagination offset | |
| region | No | Region NAME only, e.g. 'Košický kraj'. A NUTS code here returns zero — use nuts3. | |
| status | No | ||
| healthy | No | Shorthand: no bankruptcy, liquidation, restructuring or tax debt | |
| district | No | ||
| has_cves | No | ||
| has_rpvs | No | SK register of public-sector partners | |
| has_tech | No | Any detected technology at all | |
| has_email | No | ||
| has_phone | No | ||
| nis2_tier | No | essential | important | |
| legal_form | No | Legal form code, e.g. '112' = s.r.o. (SK) | |
| profit_max | No | Maximum annual profit in EUR | |
| profit_min | No | Minimum annual profit in EUR | |
| entity_type | No | Comma-separated also accepted. Natural persons are gated out of results anyway. | |
| has_website | No | ||
| is_debarred | No | Excluded from public procurement | |
| nace_prefix | No | Comma-separated NACE prefixes, e.g. '46,47' | |
| nis2_sector | No | ||
| ssl_invalid | No | ||
| country_code | No | ISO 3166-1 alpha-2, comma-separated for several markets, e.g. 'SK,CZ' | |
| credit_grade | No | Comma-separated grade letters, e.g. 'A,B' | |
| employee_max | No | Maximum headcount (NOT employees_max) | |
| employee_min | No | Minimum headcount (NOT employees_min) | |
| eu_funds_min | No | Minimum EU funds received, EUR | |
| has_tax_debt | No | ||
| is_vat_payer | No | ||
| municipality | No | Town/city name, e.g. 'Košice' | |
| turnover_max | No | Maximum annual turnover in EUR | |
| turnover_min | No | Minimum annual turnover in EUR | |
| contracts_min | No | Minimum contract count | |
| employee_size | No | Employee size-band code | |
| has_contracts | No | Has public procurement contracts | |
| in_bankruptcy | No | ||
| is_sanctioned | No | NOT 'sanctioned' | |
| nis2_in_scope | No | NOT 'nis2_scope' | |
| terminated_to | No | Terminated on or before, ISO date | |
| updated_since | No | Only rows changed since this ISO date | |
| established_to | No | Founded on or before, ISO date YYYY-MM-DD | |
| has_financials | No | ||
| in_liquidation | No | ||
| cyber_score_min | No | ||
| terminated_from | No | Terminated on or after, ISO date | |
| credit_score_max | No | ||
| credit_score_min | No | ||
| established_from | No | Founded on or after, ISO date YYYY-MM-DD | |
| in_restructuring | No | ||
| has_critical_cves | No | ||
| has_offshore_link | No |