Fulltext search + filters (public)
Public fulltext over company names, with two numeric fast-paths that bypass Meilisearch and read straight from the database (sub-100ms, always fresh):
- q = 6–8 digits → exact national ID (IČO) lookup, response mode: "ico", at most 1 hit.
- q = exactly 10 digits → exact tax ID (DIČ) lookup, response mode: "dic", up to 5 hits (DIČ is not unique in the source registers, so this returns a normal result list).
- anything else → Meilisearch with facet support, response mode: "meili".
The two fast-path ranges cannot overlap (6–8 vs. exactly 10 digits); a 9-digit query goes to Meilisearch. VAT ID (IČ DPH, SK…) lookup is NOT supported here — use the vatId field on /v1/companies/{ico}. Filters: kind, legalForm, register, status, region, isVatPayer, establishedYearMin/Max.
Request
- Base URL: https://api.orsf.sk
- URL: https://api.orsf.sk/v1/search
- Auth: none declared
Query parameters
Search term. 6–8 digits = IČO exact match, exactly 10 digits = DIČ exact match, otherwise fulltext.
Entity kind. Accepts canonical EN (company, sole_trader, other) or legacy SK.
e.g. "Spoločnosť s ručením obmedzeným"
e.g. "Obchodný register"
NUTS-3 code, e.g. "SK010" for Bratislava
Response
Search results with facets. mode is one of ico | dic | meili and tells you which engine answered: ico/dic are exact DB fast-paths (facetDistribution is always {}, estimatedTotalHits is the exact hit count), meili is fulltext with facets. The hit object shape is identical for ico and dic.
Changes
No recorded changes to this operation across all 1 revision of this API.