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

Prístup k údajom z Obchodného registra SR cez moderné REST API – jednoduché, spoľahlivé a rýchle. FirmAPI 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. JSON API posiela aj webhooky pri zmenách vo firmách.

## Rýchly štart

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

```json
{
  "data": {
    "ico": "51636549",
    "name": "Version Two s. r. o.",
    "address": "Bratislava",
    "legal_form": "s.r.o.",
    "registration_date": "2018-05-15"
  }
}
```

## Kompletné firemné dáta na dosah

- **Vyhľadávanie firiem** – podľa IČO, názvu alebo iných kritérií; autocomplete endpoint pre Select2 a podobné komponenty
- **Bezpečné a spoľahlivé** – HTTPS šifrovanie, autentifikácia cez API kľúče, rate limiting na ochranu vašej aplikácie
- **Okamžité odpovede** – priemerná doba odpovede pod 100 ms, dáta cachované a pravidelne synchronizované s ORSR

## Ako to funguje

1. **Vytvorte účet** – registrácia je zadarmo, nepotrebujete kreditnú kartu
2. **Získajte API kľúč** – vygenerujte si ho v dashboarde
3. **Integrujte** – zavolajte API a získajte firemné dáta vo formáte JSON

## Pripravení začať?

Vytvorte si účet zadarmo a získajte prístup k 20 požiadavkám mesačne bez kreditnej karty. Registrácia: https://firmapi.sk/registracia · Cenník: https://firmapi.sk/cennik.md

## Ďalšie zdroje

- API dokumentácia: https://firmapi.sk/dokumentacia.md
- Príklady použitia: https://firmapi.sk/priklady-pouzitia.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