SK + CZ Company Lookup API
REST API nad slovenským RPO + českým ARES. 44 225 217 firiem (2 156 263 SK + 1 265 155 CZ), IČO lookup 8 ms, autocomplete 12 ms, advanced-search 180 ms. Stable v1 JSON + OpenAPI 3.1, CSV exporty, Bearer auth.
Vyskúšaj teraz — zadaj IČO
No auth required pre /public/check/:ico.json. Response za ~20 ms.
Integrácia za 5 minút
# IČO lookup — no auth required (public endpoint) curl https://entyrix.com/api/v1/public/check/35757442.json # Full company detail (auth required) curl -H "Authorization: Bearer $API_KEY" \ https://entyrix.com/api/v1/companies/35757442 # Autocomplete — Meilisearch typo-tolerant, 12ms curl -H "Authorization: Bearer $API_KEY" \ "https://entyrix.com/api/v1/companies/autocomplete?q=eset&limit=5" # Bulk lookup — 100 IČO per request curl -X POST -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{"icos": ["35757442", "31322832", "00000019"]}' \ https://entyrix.com/api/v1/companies/bulk # Advanced search — CSV export (38 stĺpcov) curl -H "Authorization: Bearer $API_KEY" \ "https://entyrix.com/api/v1/companies/advanced-search.csv?country=SK&min_credit_score=80&limit=1000" \ -o top_sk_suppliers.csv
Hlavné endpointy
GET /companies/autocomplete
Meilisearch typo-tolerant — "sloventka" → "Slovnaft". Debounce z frontend input-u.
GET /companies/lookup
Exact IČO B-tree lookup, vracia základný profile + compliance flags + credit grade.
GET /companies/:ico
Plný detail — profile + financials (posledné 5 rokov) + enrichment (website, tech, DNS).
GET /companies/:ico/full
Aggregate endpoint — 14 sekcií naraz (contracts, UBO, sanctions, credit, NIS2, …).
GET /companies/advanced-search
30+ filters (NACE, country, NUTS, credit, turnover, NIS2, …) + pagination.
GET /companies/advanced-search.csv
CSV export, 38 stĺpcov. Až 10k riadkov / request.
POST /companies/bulk
Batch lookup — 100 IČO / request (JSON array), vracia parallel response.
GET /companies/by-lei
GLEIF Legal Entity Identifier lookup — 20-char LEI kód → IČO + detail.
GET /bank-accounts/lookup
FS IBAN register (312k účtov, 212k firiem) — invoice-fraud prevention.
POST /monitoring/subscriptions
Watch firmu — webhook on jakomkoľvek change (addresa, štatutár, konkurz, finančný výkaz).
GET /vat/validate
EU VIES VAT validator (27 štátov) s 24h cache.
vs štátne registre
| Entyrix | Štátne registre (RPO / ARES) | |
|---|---|---|
| IČO lookup speed | 8 ms | 300 ms – 14 s |
| Rate-limit (free) | 600 req/min | 60 req/min |
| SK + CZ v jednom API | ✓ (+ postupne EÚ) | iba per krajina, 2 integrácie |
| Financial statements (RUZ) | bigint cents, 5+ rokov | — |
| Sankcie screening | OFAC + EU + UN + UK | — |
| UBO (RPVS) | 52k partnerov, 136k UBO | — |
| Verejné zmluvy (CRZ) | 5,57M kontraktov | — |
| OpenAPI 3.1 spec | ✓ + Swagger UI | XML schema iba |
| CSV export | 38 stĺpcov, 10k/req | — |
Typické nasadenia
Invoice validation
Pred výplatou: IBAN → firma (FS) + VAT (VIES) + sankcie (OpenSanctions) + bankrupt (OV). 3 API calls, 50 ms total. Blokuj payment ak sanction hit.
CRM enrichment
IČO z form submit → GET /companies/:ico/full → auto-fill address, NACE, turnover range. Re-enrichment týždenne cez bulk.
Auto-complete firiem
Frontend search input → /companies/autocomplete (12 ms, typo-tolerant). UX lepší ako ARES (300 ms, žiadna tolerancia).
Marketing lists
advanced-search.csv — cieľaj SK firmy >€1M tržby v retail s website + email. TAM calculator pre B2B sales.
AR credit check
Pre-invoice: grade + tax_debt + in_bankruptcy. D-F klienti iba cash-on-delivery. Zníži DSO + bad debt.
Change monitoring
Monitoring webhook — subscribe critical vendors → dostaneš webhook keď sa zmení konkurz flag, štatutár, bank account.
Často kladené otázky
Ako dostanem API kľúč a koľko to stojí?
Free tier: 600 req/min bez auth pre všetky /api/v1/public/* endpointy (stats, rankings, data-feeds, check/:ico, transparency feeds). Paid tier pre authenticated endpointy (lookup/:ico, search, advanced-search, bulk, detail+subresources, CSV export, monitoring webhooks) — pricing finalizujeme, launch Q2 2026, early-adopter contact: [email protected]. Dotaz s use-case → dostanete dev API kľúč s 600 req/min na testovanie. Pre enterprise SLA (10k req/min + dedicated support + SLA 99.9%) po dohode.
Prečo nejsť priamo na štátne registre alebo iné platformy?
Tri dôvody: (1) Speed — náš IČO lookup 8 ms vs raw registre v rozmedzí stoviek ms až sekundy s tvrdými rate-limit. (2) Unified schéma — jeden request format pre SK aj CZ (a postupne celú EÚ), jedna autentifikácia, jedna rate-limit policy. Nemusíš pisať N integrácií. (3) Enrichment — okrem základných register fieldov máme pripojené FS (DPH register, tax reliability, bank accounts), CRZ (public contracts supplier side), RUZ (finančné výkazy), OpenSanctions (sankcie+PEP+crime), GLEIF (LEI), RPVS (UBO), NIS2 scoping, credit score. Jeden API call vráti všetko cez /companies/:ico/full.
Ako často sa dáta aktualizujú?
RPO: týždenne (Mon 05:00 UTC z Slovensko.Digital S3 dump ~1.1 GB gzipped). ARES: mesačne (1. dňa 10:00 UTC z ares.gov.cz VREO tar.gz ~800 MB). Finančné výkazy (RUZ): denne incremental (nové záznamy cez registeruz.sk REST API) + weekly full. Sankcie: denne (OpenSanctions goldencopy 04:30 UTC). CRZ zmluvy: týždenne. Ingestion history + last-updated timestamp per source: /status.
Aké formáty JSON vraciate? Sú stabilné?
Všetky endpointy vracajú { data, meta: { request_id, duration_ms, cached } } wrapper. Šéma per endpoint v OpenAPI 3.1 spec + Swagger UI. Field names v camelCase (consistent). Money fields vždy bigint cents (never float — int4 preliezal pri firmách >€21M). Dátumy ISO 8601 (YYYY-MM-DD). Verzia v1 stable — breaking changes pôjdu cez /v2 prefix, v1 bude deprecated min. 12 mesiacov dopredu.
Rate-limit + error handling?
429 Too Many Requests s Retry-After header po prekročení 600 req/min (per API kľúč alebo IP pre public endpointy). X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset headers na každom response. 503 Service Unavailable počas Monday 5-7 AM batch (plánujeme znížiť na 0 cez L2 snapshot pattern, WIP). 404 pre missing ICO (nie prázdne data). Exponential backoff recommended.
Môžem bulk-lookupovať 10k+ firiem?
Áno. POST /api/v1/companies/bulk — 100 IČO / request (array body), ~10 ms/each (1 s na batch 100). Pre 10k kontact list: 100 paralelných requestov s Promise.all dobehne za ~15 s. Pre ešte väčšie exports (100k+) použi GET /api/v1/companies/advanced-search.csv so 38 stĺpcami (až 10k riadkov / request, paginácia cez ?cursor=). Ak bulk je >1M firiem, máme custom export (CSV snapshot, 5 GB, kontakt).
SLA? Uptime?
Public stats: /status je verejný. Aktuálne beží single Hetzner CX23 VPS (2 vCPU, 4 GB RAM, 40 GB SSD, ~€6/mes) — no formal SLA pre free tier, but best-effort 99.5% uptime (monitored cez UptimeRobot). Enterprise tier bude multi-region s contractual 99.9% SLA + dedicated backup Hetzner + failover DNS. Weekly snapshot backup, daily DB dump. Incidents log: /status.
Free dev API kľúč do 24 h
Kontakt na [email protected] s use-case → dostanete dev API kľúč s 600 req/min na testovanie.