# FirmAPI – Dátové zdroje a polia

FirmAPI agreguje a krížovo overuje 38 verejných registrov a pokrýva 1,300,000+ subjektov s IČO. Namiesto scrapovania ORSR, sťahovania ZIP súborov z Finančnej správy a volania SOAP služby VIES získate všetky údaje jedným HTTP požiadavkom. Pri každom údaji v odpovedi je uvedený zdrojový register aj čas poslednej synchronizácie.

## Legenda

- **Základné** – dostupné vo všetkých plánoch vrátane bezplatného.
- **Obohatené** – dostupné v platených plánoch podľa tarify.
- Zdroj označuje autoritatívny register, z ktorého konkrétny údaj pochádza.

## Polia v odpovedi API podľa kategórie

### 1. Identifikácia firmy (Základné)

Základné identifikátory, ktoré jednoznačne určujú subjekt.

- **IČO** – Osemmiestne identifikačné číslo organizácie.
- **Obchodné meno** – Oficiálny názov firmy zapísaný v registri.
- **Právna forma** – Kód aj slovný opis (napr. s. r. o., a. s., živnostník).
- **ORSR ID** – Identifikátor v Obchodnom registri SR, ak je firma v ňom zapísaná.
- **Zdrojový register** – Označuje, či firma pochádza z RPO alebo z Obchodného registra.
- **Stav** – Aktívna alebo neaktívna firma.
- **SK-NACE** – Kód a slovný opis hlavnej ekonomickej činnosti.
- **Dátum vzniku** – Dátum zápisu firmy do registra.
- **Dátum zániku** – Dátum ukončenia činnosti, ak firma zanikla.

### 2. Adresa a sídlo (Základné)

Registrované sídlo firmy so štruktúrovanými zložkami.

- **Ulica a číslo** – Štruktúrovaná ulica, orientačné a súpisné číslo.
- **Obec** – Mesto alebo obec sídla.
- **PSČ** – Poštové smerovacie číslo.
- **Krajina** – Kód krajiny podľa ISO 3166.
- **Overená adresa z ORSR** – Detailná adresa zverená priamo z Obchodného registra.

### 3. Štatutárne orgány a spoločníci (Základné)

Kompletná vlastnícka a riadiaca štruktúra zo zápisu v Obchodnom registri.

- **Spoločníci** – Meno, adresa, výška vkladu a obchodný podiel každého spoločníka. Rozlišujeme fyzické a právnické osoby (pri právnických aj IČO).
- **Štatutárne orgány** – Mená konateľov alebo členov predstavenstva, ich funkcia, adresa a spôsob konania.
- **Predmety podnikania** – Úplný zoznam činností zapísaných v Obchodnom registri.
- **Základné imanie** – Výška základného imania a stav splatenia.

### 4. Daňové a DPH údaje (Obohatené)

Kompletná sada daňových identifikátorov a ich overenie v slovenských aj európskych registroch.

- **DIČ** – Daňové identifikačné číslo zo zoznamu Registra účtovných závierok.
- **IČ DPH** – Identifikačné číslo pre DPH zo zoznamu Finančnej správy SR.
- **Status platiteľa DPH** – Aktuálny stav z týždenne aktualizovaného zoznamu Finančnej správy.
- **VIES overenie** – Overenie platnosti IČ DPH priamo v službe Európskej komisie vrátane dátumu poslednej kontroly.
- **Príslušný daňový úrad** – Miestne príslušný daňový úrad firmy.
- **Index daňovej spoľahlivosti** – Hodnotenie Finančnej správy (spoľahlivý, menej spoľahlivý, nespoľahlivý).
- **Vymazanie z registra platiteľov DPH** – Informácia, či bol subjekt vymazaný zo zoznamu platiteľov DPH, vrátane dátumu a dôvodu.

### 5. Finančné údaje a účtovné závierky (Obohatené)

Ročné hospodárske výsledky firiem získané z verejne zverejnených účtovných závierok.

- **Tržby** – Ročné tržby z predaja výrobkov a služieb.
- **Výsledok hospodárenia** – Čistý zisk alebo strata za účtovné obdobie.
- **Celkové aktíva** – Celková hodnota majetku firmy.
- **Vlastné imanie** – Hodnota vlastného imania na konci účtovného obdobia.
- **Záväzky** – Celková výška krátkodobých a dlhodobých záväzkov.
- **Počet zamestnancov** – Priemerný evidenčný počet zamestnancov podľa účtovnej závierky.
- **História účtovných závierok** – Prístup k viacročnej histórii závierok vrátane typu výkazu (mikro, malá, veľká účtovná jednotka).

### 6. Bankové účty (Obohatené)

Zverejnené bankové účty firmy podľa registra Finančnej správy.

- **IBAN** – Medzinárodné číslo bankového účtu.
- **BIC / SWIFT** – Identifikačný kód banky.
- **Názov banky** – Obchodné meno finančnej inštitúcie.

### 7. Kontaktné údaje (Obohatené)

E-mailové adresy, telefónne čísla a webové stránky získané z verejných zdrojov.

- **E-mail** – Verejne dostupné e-mailové adresy firmy.
- **Telefón** – Verejne dostupné telefónne čísla firmy.
- **Web** – Oficiálna webová stránka firmy.

### 8. Dlžníci a nedoplatky (Obohatené)

Krížovo overená kontrola, či má firma nedoplatky voči štátu alebo zdravotným poisťovniam.

- **Sociálna poisťovňa** – Nedoplatky voči Sociálnej poisťovni vrátane sumy a dátumu zverejnenia.
- **Finančná správa** – Daňové nedoplatky voči Finančnej správe SR.
- **Všeobecná zdravotná poisťovňa** – Nedoplatky voči VšZP.
- **Dôvera zdravotná poisťovňa** – Nedoplatky voči zdravotnej poisťovni Dôvera.
- **Union zdravotná poisťovňa** – Nedoplatky voči zdravotnej poisťovni Union.

### 9. Insolvencie a exekúcie (Obohatené)

Konkurzné, reštrukturalizačné a exekučné konania proti firme.

- **Insolvenčné konania** – Typ konania (konkurz, reštrukturalizácia, likvidácia), spisová značka, súd, správca a dátumy.
- **Poverenia na exekúciu** – ECLI, spisová značka súdu, meno exekútora, vymáhaná pohľadávka a dátumy poverenia.

### 10. Obchodný vestník (Obohatené)

Oznámenia a zverejnenia firmy v Obchodnom vestníku SR.

- **Zápisy v Obchodnom vestníku** – Sekcia, nadpis a dátum zverejnenia najnovších oznámení vrátane celkového počtu.

### 11. Verejný sektor (Obohatené)

Zmluvy s verejnou správou, výsledky verejného obstarávania a registrácia partnera verejného sektora.

- **Verejné zmluvy (CRZ)** – Počet a celková hodnota zverejnených zmlúv firmy v Centrálnom registri zmlúv.
- **Verejné obstarávanie** – Počet a celková hodnota vysúťažených zákaziek z Úradu pre verejné obstarávanie.
- **RPVS – partneri verejného sektora** – Registrácia v RPVS, platnosť zápisu a zoznam konečných užívateľov výhod.

### 12. Regulácia NBS (Obohatené)

Informácie o subjektoch finančného trhu regulovaných Národnou bankou Slovenska.

- **Licencie NBS** – Zoznam licencií a povolení vydaných Národnou bankou Slovenska.

## Živé zdroje (38)

- **RPO – Register právnických osôb** – Hlavný register všetkých právnických osôb v SR. Identifikácia, právna forma, sídlo.
- **Obchodný register SR (ORSR)** – Spoločníci, štatutári, základné imanie, predmety podnikania, výpisy z OR.
- **Register účtovných závierok** – DIČ, kompletné účtovné závierky, finančné výkazy a viacročná história.
- **SK-NACE (ŠÚ SR)** – Klasifikácia ekonomických činností podľa Štatistického úradu SR.
- **Finančná správa – platitelia DPH** – Aktuálny zoznam platiteľov DPH s IČ DPH aktualizovaný týždenne.
- **FS – Index daňovej spoľahlivosti** – Hodnotenie daňovej spoľahlivosti firmy Finančnou správou SR.
- **FS – Vymazaní platitelia DPH** – Firmy vymazané zo zoznamu platiteľov DPH s dátumom a dôvodom.
- **EU VIES** – Systém Európskej komisie na overenie platnosti IČ DPH v reálnom čase.
- **Sociálna poisťovňa – dlžníci** – Zoznam dlžníkov Sociálnej poisťovne s výškou nedoplatku.
- **Finančná správa – daňoví dlžníci** – Daňoví dlžníci zverejnení Finančnou správou SR.
- **VšZP – dlžníci** – Dlžníci Všeobecnej zdravotnej poisťovne.
- **Dôvera – dlžníci** – Dlžníci zdravotnej poisťovne Dôvera.
- **Union – dlžníci** – Dlžníci zdravotnej poisťovne Union.
- **Insolvenčný register** – Konkurzné, reštrukturalizačné a likvidačné konania firiem v SR.
- **Obchodný vestník SR** – Úradné oznámenia a zverejnenia firiem v Obchodnom vestníku.
- **RPVE – Poverenia na exekúciu** – Register poverení exekútorov na vykonanie exekúcie proti subjektu.
- **Inšpektorát práce – Nelegálne zamestnávanie** – Zoznam zamestnávateľov pokutovaných za nelegálne zamestnávanie.
- **Súdne rozhodnutia (otvorenesudy.sk)** – Rozhodnutia slovenských súdov, v ktorých firma vystupuje ako účastník konania.
- **REPLIK – Zoznam správcov** – Register správcov konkurznej podstaty a reštrukturalizačných správcov.
- **CRZ – Centrálny register zmlúv** – Verejné zmluvy uzatvorené so štátom a verejnou správou.
- **Verejné obstarávanie** – Zákazky, v ktorých firma vystupuje ako úspešný uchádzač alebo dodávateľ.
- **ÚVO – Zoznam hospodárskych subjektov** – Register kvalifikovaných dodávateľov vedený Úradom pre verejné obstarávanie.
- **ÚVO – Verejní obstarávatelia** – Subjekty evidované ako verejní obstarávatelia vrátane ich klasifikácie.
- **ÚVO – Zákaz účasti vo verejnom obstarávaní** – Zoznam subjektov s uloženým zákazom účasti vo verejnom obstarávaní.
- **ÚVO – Evidencia referencií** – Hodnotenia a referencie firiem z realizovaných verejných zákaziek.
- **RPVS – Partneri verejného sektora** – Register partnerov verejného sektora vrátane konečných užívateľov výhod.
- **TED – Tenders Electronic Daily** – Európske verejné zákazky zverejnené v úradnom vestníku EÚ.
- **EU – Konsolidované sankcie (FSF)** – Konsolidovaný zoznam finančných sankcií Európskej únie.
- **OFAC – Sankčné zoznamy USA** – Sankčné zoznamy Úradu pre kontrolu zahraničných aktív (OFAC) Ministerstva financií USA.
- **GLEIF – Identifikátor LEI** – Globálny identifikátor právnickej osoby (LEI) vrátane väzieb na materské spoločnosti.
- **NBS – Subjekty finančného trhu** – Licencované finančné inštitúcie regulované Národnou bankou Slovenska.
- **MV SR – Register SBS** – Držitelia licencií na prevádzkovanie súkromnej bezpečnostnej služby.
- **JISCD – Register dopravcov** – Držitelia licencií a eurolicencií na prevádzkovanie cestnej dopravy.
- **ÚRSO – Držitelia povolení** – Subjekty s povolením v sieťových odvetviach (energetika, voda) regulované ÚRSO.
- **Register sociálnych podnikov** – Firmy s priznaným štatútom registrovaného sociálneho podniku.
- **Sociálna poisťovňa – Register zamestnávateľov** – Registrácia firmy ako zamestnávateľa vrátane orientačného počtu zamestnancov.
- **SOI – Register cestovných kancelárií** – Cestovné kancelárie vrátane poistenia proti insolvencii a prípadných zákazov.
- **ŠVPS – Schválené prevádzkarne** – Schválené potravinárske a veterinárne prevádzkarne pod dohľadom Štátnej veterinárnej a potravinovej správy.

## Pripravované zdroje

- **ITMS2014+ (EU fondy)** – Prijímatelia štrukturálnych fondov EÚ vrátane výšky podpory a projektov.

## Ako dáta získate

Všetky údaje sú dostupné cez REST API. Jeden HTTP požiadavok vráti kompletný JSON objekt firmy, rozsah obohatenia riadi parameter `scope` (dostupnosť jednotlivých scopov závisí od plánu, viac na https://firmapi.sk/dokumentacia.md):

- Vyhľadanie firmy podľa IČO – `GET /v1/company/ico/{ico}?scope=all`
- Vyhľadanie firmy podľa ORSR ID – `GET /v1/company/id/{orsrId}`
- Vyhľadávanie podľa názvu – `GET /v1/search/name?q=`
- Autocomplete pre formuláre – `GET /v1/search/autocomplete?q=`
- Pokročilé vyhľadávanie podľa viacerých kritérií – `GET /v1/search/advanced`
- Dávkové vyhľadanie viacerých IČO naraz – `POST /v1/batch/ico`
- Dávkové vyhľadanie podľa zoznamu názvov – `POST /v1/batch/names`
- Webhooky s notifikáciami pri každej zmene údajov – `POST /v1/notifications`

Príklad odpovede `GET /v1/company/ico/51636549?scope=all`:

```json
{
  "data": {
    "ico": "51636549",
    "name": "Version Two s. r. o.",
    "legal_form": "Spoločnosť s ručením obmedzeným",
    "legal_form_code": "112",
    "address": {
      "street": "Mlynské nivy 48",
      "city": "Bratislava",
      "postal_code": "82109",
      "country": "SK"
    },
    "established_date": "2018-03-15",
    "terminated_date": null,
    "source_register": "orsr",
    "status": "active",
    "orsr_id": "127891/B",
    "business_activities": [
      "Počítačové služby",
      "Poskytovanie softvéru – predaj hotových programov",
      "Sprostredkovateľská činnosť v oblasti obchodu",
      "Reklamné a marketingové služby"
    ],
    "registered_capital": "5 000 EUR",
    "shareholders": [
      {
        "name": "Mgr. Mario Chamuty",
        "address": "Bratislava",
        "share_amount": "5 000 EUR",
        "share_percentage": "100%",
        "is_company": false,
        "ico": null
      }
    ],
    "statutory_body": [
      {
        "name": "Mgr. Mario Chamuty",
        "role": "konateľ",
        "address": "Bratislava, Slovensko",
        "acting_method": "Za spoločnosť koná konateľ samostatne."
      }
    ],
    "nace_code": "62010",
    "nace_description": "Počítačové programovanie",
    "tax": {
      "dic": "2120876543",
      "ic_dph": "SK2120876543",
      "vies_valid": true,
      "vies_verified_at": "2026-04-11T06:00:00+00:00",
      "is_vat_payer": true
    },
    "tax_reliability": {
      "index": "spoľahlivý",
      "is_reliable": true
    },
    "erased_vat": {
      "is_erased": false,
      "entries": []
    },
    "bank_accounts": [
      {
        "iban": "SK89 1100 0000 0029 4305 4158",
        "bank_name": "Tatra banka, a. s.",
        "is_published": true
      }
    ],
    "contacts": {
      "email": ["info@versiontwo.sk"],
      "phone": ["+421 2 5729 1111"],
      "website": ["https://versiontwo.sk"]
    },
    "financials": {
      "year": 2024,
      "revenue": "420680.00",
      "profit": "68420.00",
      "assets": "315200.00",
      "employees_count": 7
    },
    "financial_statements": {
      "latest": {
        "year": 2024,
        "statement_type": "riadna",
        "total_assets": "315200.00",
        "total_equity": "187450.00",
        "total_liabilities": "127750.00",
        "total_revenue": "420680.00",
        "net_profit": "68420.00",
        "template_type": "mikro",
        "size_category": "micro"
      },
      "available_years": [2021, 2022, 2023, 2024]
    },
    "debtor_status": { "is_debtor": false, "sources": [] },
    "insolvency": { "has_active_proceedings": false, "proceedings": [] },
    "execution_authorizations": { "has_active_authorizations": false, "total_count": 0, "authorizations": [] },
    "commercial_bulletin": {
      "total_entries": 12,
      "latest_entries": [
        { "section": "Zbierka listín", "heading": "Účtovná závierka 2024", "published_at": "2025-06-12" },
        { "section": "Zmeny v OR", "heading": "Zmena sídla spoločnosti", "published_at": "2024-09-03" }
      ]
    },
    "public_contracts_summary": { "count": 3, "total_value": 48700.00 },
    "procurement_summary": { "count": 1, "total_awarded_value": 24500.00 },
    "rpvs": { "is_public_sector_partner": false, "registrations": [] },
    "nbs": { "is_regulated": false, "license_types": [] }
  },
  "meta": {
    "rpo_updated_at": "2026-04-11T04:15:00+00:00",
    "source": "database",
    "orsr_synced_at": "2026-04-10T22:40:11+00:00",
    "enriched_at": "2026-04-11T05:02:48+00:00",
    "profile_built_at": "2026-04-11T05:02:49+00:00"
  }
}
```

## Aktuálnosť údajov

Každá odpoveď obsahuje metadáta o čerstvosti údajov (`meta.*_at`), takže vždy viete, koľko sú staré:

- **RPO – týždenná synchronizácia** – Hlavný register právnických osôb sa synchronizuje raz týždenne, zvyčajne v nedeľu ráno.
- **ORSR – obohatenie na požiadanie** – Detaily z Obchodného registra sa dopĺňajú asynchrónne po prvom dopyte na firmu. Existujúce záznamy sa automaticky obnovujú, keď prekročia 30 dní.
- **Finančná správa – týždenne** – Zoznam platiteľov DPH, vymazaných platiteľov a index daňovej spoľahlivosti sa importujú raz týždenne.
- **VIES – v reálnom čase** – Overenie IČ DPH prebieha priamo v službe Európskej komisie pri každom požiadavku.
- **Dlžníci – týždenne až mesačne** – Sociálna poisťovňa sa aktualizuje týždenne, Finančná správa a zdravotné poisťovne (VšZP, Dôvera, Union) mesačne – podľa publikačnej frekvencie jednotlivých zdrojov.

## Ďalšie zdroje

- API dokumentácia: https://firmapi.sk/dokumentacia.md
- Príklady použitia: https://firmapi.sk/priklady-pouzitia.md
- Cenník: https://firmapi.sk/cennik.md
- Overenie firmy: https://firmapi.sk/overenie-firmy.md
- Monitoring firiem: https://firmapi.sk/monitoring-firiem.md
- Porovnanie s FinStat: https://firmapi.sk/porovnanie/finstat.md
- Registrácia (zadarmo, bez kreditnej karty): https://firmapi.sk/registracia

---

Prevádzkovateľ: Version Two s.r.o., https://www.versiontwo.sk