Stručne
- Register právnických osôb (RPO) spája obchodný register, živnostenský register a ďalšie zdrojové registre; zverejňuje ho Štatistický úrad SR.
- Držíme viac ako 2,2 milióna slovenských subjektov a každú noc spracujeme prírastok zmien.
- Vyhľadávanie znesie preklepy a chýbajúcu diakritiku; detail vracia adresy, predmety činnosti, štatutárov a spoločníkov.
- Poškodenú diakritiku a zástupné dátumy registra opravujeme a pôvodný text ostáva dostupný.
- Vydavateľ
- Štatistický úrad SR
- Rozsah
- viac ako 2,2 milióna subjektov (právnické osoby aj živnostníci)
- Aktualizácia
- denne o 3:00 UTC, z denných prírastkov
- Endpointy
- /organizations, /organizations/{cin}, /organizations/{cin}/detail, /organizations/{cin}/people, /organizations/batch
- Licencia zdroja
- otvorené dáta
Čo register obsahuje
- Názov, IČO, právnu formu, dátum vzniku a zániku.
- Adresy sídla vrátane historických, s dátumami platnosti.
- Predmety činnosti a SK NACE.
- Štatutárne orgány, spoločníkov a ich vklady.
Čo k nemu pridávame
Register preberá chyby svojich zdrojov. Diakritika býva rozložená („Vy´roba“ namiesto „Výroba“), namiesto neznámeho dátumu stojí 1. 1. 1800 a pevná medzera sa mení na otáznik. Opravujeme len to, čo vieme dokázať z dát samotných, a každú zmenu s pôvodným textom vraciame na /organizations/{cin}/corrections.
Pri fyzických osobách v detaile nevraciame osobný identifikátor a adresu uvádzame len na úroveň obce.
curl https://api.apino.sk/api/v1/organizations/31333532 \
-H "Authorization: Bearer $APINO_KEY"
{
"id": 686088,
"country_code": "SK",
"name": "ESET, spol. s r.o.",
"cin": "31333532",
"street": "Einsteinova 24",
"municipality": "Bratislava",
"postal_code": "851 01",
"address": "Einsteinova 24, Bratislava, 851 01",
"is_terminated": false
}Na čo si dať pozor
- IČO ukladajte ako text. Úvodné nuly sú jeho súčasťou.
- To isté IČO môže existovať v slovenskom aj českom registri; bez parametra country vtedy API odpovie 300 a ponúkne oba.
- Hlavička X-Data-Synced-At hovorí, kedy sme register naposledy synchronizovali.