# FirmAPI – API pre slovenské firemné dáta

FirmAPI je REST API pre prístup k údajom o slovenských firmách. Agreguje 38 verejných registrov do jedného rozhrania a pokrýva 1,300,000+ subjektov s IČO – obchodné spoločnosti, živnostníkov aj neziskové organizácie.

## Čo API poskytuje

- **Identifikačné údaje** – názov, IČO, DIČ, IČ DPH, sídlo, právna forma, štatutári a spoločníci (Obchodný register SR, Register právnických osôb)
- **Finančné dáta** – účtovné závierky, tržby, zisk (Register účtovných závierok)
- **Rizikové signály** – dlhy voči Sociálnej poisťovni, zdravotným poisťovniam a Finančnej správe, insolvencie, exekučné poverenia, index daňovej spoľahlivosti, vymazaní platitelia DPH
- **Sankčné zoznamy** – kontrola voči zoznamom EÚ a OFAC vrátane osôb vo vedení
- **Verejné zákazky** – zmluvy z CRZ, verejné obstarávania z ÚVO a TED
- **Monitoring** – webhooky pri zmenách vo firmách (nový dlh, insolvencia, zmena konateľa…)

## Rýchly štart

```bash
curl -H "X-API-Key: fa_your_key" \
  "https://firmapi.sk/v1/company/ico/51636549"
```

Registrácia je zadarmo (20 kreditov mesačne, bez platobnej karty): https://firmapi.sk/registracia

## Ďalšie zdroje

- API dokumentácia: https://firmapi.sk/dokumentacia.md
- Dátové zdroje: https://firmapi.sk/ake-data-poskytujeme.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
- SDK: PHP (`composer require firmapi/phpsdk`) a JavaScript/TypeScript (`npm install firmapi`)

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