# Register právnických osôb (RPO)

> Najširší slovenský register subjektov: obchodné spoločnosti, živnostníci, neziskovky aj orgány verejnej moci. Vyhľadávanie podľa IČO cez REST API.

RPO je najširšia evidencia slovenských subjektov. Na rozdiel od Obchodného registra pokrýva aj živnostníkov, občianske združenia, nadácie a orgány verejnej moci, takže je to jediný register, v ktorom nájdete prakticky každé platné IČO.

## Čo register obsahuje
- Názov subjektu vrátane histórie predchádzajúcich názvov
- Sídlo v štruktúrovanej podobe – ulica, obec, PSČ, kód okresu
- Právna forma a jej číselný kód
- Dátum vzniku a prípadného zániku subjektu
- Zdrojový register, z ktorého subjekt pochádza (obchodný, živnostenský, iný)
- Predmety podnikania vrátane pozastavených a zaniknutých

## Polia, ktoré vraciame

| Pole | Význam |
| --- | --- |
| `ico` | Osemmiestne identifikačné číslo, vždy doplnené zľava nulami. |
| `name` | Aktuálny názov subjektu. |
| `legal_form` | Právna forma slovom, napríklad Spoločnosť s ručením obmedzeným. |
| `legal_form_code` | Číselný kód právnej formy podľa štatistickej klasifikácie. |
| `address` | Objekt so sídlom: street, city, postal_code, country. |
| `established_date` | Dátum vzniku subjektu vo formáte ISO. |
| `terminated_date` | Dátum zániku, alebo null ak je subjekt aktívny. |
| `source_register` | Register, z ktorého záznam pochádza. |
| `status` | active alebo terminated, odvodené od dátumu zániku. |

## Ako si dáta vyžiadate

```http
GET /v1/company/ico/51636549

{
  "ico": "51636549",
  "name": "Version Two s. r. o.",
  "legal_form": "Spoločnosť s ručením obmedzeným",
  "status": "active"
}
```

## Ako často aktualizujeme

Týždenne. Kompletný dump Registra právnických osôb importujeme raz za týždeň v nedeľu ráno – RPO sa ako celok publikuje v tomto rytme, takže častejší import by len sťahoval to isté.

## Na čo sa to používa

RPO je prvý dopyt v každom scenári, kde používateľ zadá IČO. Overí, že subjekt existuje, vráti presný názov a adresu do formulára a povie, či firma stále funguje alebo už zanikla.

Pretože pokrýva aj živnostníkov, je to jediný zdroj, ktorý zvládne našepkávač pre celý slovenský trh. Obchodný register by vám v ňom vynechal státisíce subjektov.

## Časté otázky

### Obsahuje RPO aj živnostníkov?

Áno. Práve tým sa líši od Obchodného registra. RPO eviduje aj fyzické osoby podnikateľov, občianske združenia, nadácie a orgány verejnej moci.

### Nájdem tu spoločníkov a konateľov?

Nie. RPO neobsahuje štruktúru vlastníctva ani štatutárne orgány. Tie sú v Obchodnom registri a FirmAPI ich k rovnakému IČO dopĺňa automaticky.

### Čo znamená, keď je terminated_date vyplnený?

Subjekt zanikol – bol vymazaný z registra. Záznam v databáze ponechávame, pretože pri kontrole starších faktúr a zmlúv potrebujete vedieť, že firma v tom čase existovala.