Register firiem a živnostníkov

2 287 669 firiem a živnostníkov v databáze, priebežne aktualizované

Pre vývojárov Hľadáte API pre svoj projekt?

Jeden profil. Všetky verejné údaje o firme.

Údaje z Registra právnických osôb a Finančnej správy spájame podľa IČO do jedného prehľadného profilu.

Obchodné meno a IČO Presný názov firmy a jej identifikačné číslo.
DIČ a IČ DPH Daňové identifikátory z Finančnej správy, párované na IČO.
Sídlo Adresa registrovaného sídla firmy.
Právna forma s.r.o., a.s., živnostník, občianske združenie a ďalšie.
Štatutári a spoločníci Kto firmu zastupuje a kto v nej má podiel.
Predmety činnosti Činnosti, na ktoré je firma oprávnená.
Registrácia a ďalšie záznamy Registrový súd, oddiel, vložka, dátum vzniku a ďalšie verejné údaje.

Vyhľadať firmu

Firemné dáta priamo vo vašom produkte.

Napojte svoju aplikáciu na aktuálnu databázu slovenských firiem prostredníctvom jednoduchého API.

Získať API kľúč zadarmo Pozrieť dokumentáciu

20 dotazov za minútu

s bezplatným API kľúčom. Odpoveď v JSON-e, popis v OpenAPI 3.

Ako začať

Od registrácie po prvú odpoveď z API vedú tri kroky.

Vytvorte si účet

Stačí e-mail a heslo. Zadarmo, do 20 dotazov za minútu na kľúč.
Potvrďte e-mailovú adresu

Kliknite na odkaz v e-maile. Tým sa aktivuje kľúč, ktorý dostanete hneď pri registrácii.
Použite kľúč v aplikácii

Kľúč pošlite v hlavičke X-API-Key, prípadne ako Authorization: Bearer.

        
            curl -H "X-API-Key: rpo_tvoj_kluc" \
              "https://www.safybe.com/api/companies?name=ESET+sro"

        
            <?php
            
            $query = http_build_query(['name' => 'ESET sro']);
            $context = stream_context_create([
                'http' => ['header' => 'X-API-Key: rpo_tvoj_kluc'],
            ]);
            
            $response = file_get_contents("https://www.safybe.com/api/companies?{$query}", false, $context);
            $result = json_decode($response, true);
            
            foreach ($result['items'] as $company) {
                printf("%s  %s\n", $company['cin'], $company['name']);
            }
        
    

        
            <?php
            
            $query = http_build_query(['name' => 'ESET sro']);
            
            $ch = curl_init("https://www.safybe.com/api/companies?{$query}");
            curl_setopt_array($ch, [
                CURLOPT_RETURNTRANSFER => true,
                CURLOPT_HTTPHEADER => ['X-API-Key: rpo_tvoj_kluc'],
            ]);
            
            $response = curl_exec($ch);
            $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
            curl_close($ch);
            
            if ($status !== 200) {
                throw new RuntimeException("API vrátilo {$status}: {$response}");
            }
            
            foreach (json_decode($response, true)['items'] as $company) {
                printf("%s  %s\n", $company['cin'], $company['name']);
            }
        
    

        
            const query = new URLSearchParams({ name: 'ESET sro' });
            
            const response = await fetch(`https://www.safybe.com/api/companies?${query}`, {
                headers: { 'X-API-Key': 'rpo_tvoj_kluc' },
            });
            
            const { items } = await response.json();
            items.forEach((company) => console.log(company.cin, company.name));

        
            import requests
            
            response = requests.get(
                "https://www.safybe.com/api/companies",
                params={"name": "ESET sro"},
                headers={"X-API-Key": "rpo_tvoj_kluc"},
            )
            
            for company in response.json()["items"]:
                print(company["cin"], company["name"])
        
    

200 OKapplication/json

{ "total": 1, "items": [ { "cin": "31333532", "name": "ESET, spol. s r.o.", … } ] }

Kľúč nahraďte svojím z účtu. Odpoveď je JSON s poľom items a celkovým počtom v total.

Endpointy

Základná adresa https://www.safybe.com

Otvoriť dokumentáciu API

Firmy

vyžaduje API kľúč

GET/api/companies

Vyhľadanie podľa IČO (cin) alebo názvu (name).
GET/api/companies/{cin}

Detail firmy podľa IČO.
GET/api/cin/{cin}

Skrátený výpis firmy podľa IČO — názov, sídlo, DIČ, IČ DPH, registračné číslo.
GET/api/search

Návrhy firiem pri písaní (q) — IČO, názov a obec.

Služba a dokumentácia

bez kľúča

GET/api/doc

Interaktívna dokumentácia.
GET/api/doc.json

OpenAPI 3 dokument, aj ako /api/doc.yaml.
GET/api/health

Kontrola, či služba beží.

Ako sa dáta udržiavajú

Každý záznam prejde štyrmi krokmi, kým sa objaví vo vyhľadávaní a v odpovedi API.

Import

Dumpy Registra právnických osôb a informačných zoznamov Finančnej správy sa načítajú do Postgresu.

RPO V2 + FS → Postgres
Normalizácia

Zdroj je historizovaný — každý údaj má platnosť od a do. Vyberie sa z neho aktuálny stav a k IČO sa doplní DIČ a IČ DPH.

platnosť_do = null → aktuálny stav
Indexácia

Výsledok ide do Elasticsearchu s analyzátorom pre slovenčinu, ktorý si poradí s diakritikou aj so zápismi právnych foriem.

„eset sro“ ≈ „ESET, spol. s r.o.“
Synchronizácia

Zmeny zo Slovensko.Digital sa doťahujú priebežne, takže register nezostarne.

Slovensko.Digital ↻ priebežne

Register firiem a živnostníkov

Jeden profil. Všetky verejné údaje o firme.

Firemné dáta priamo vo vašom produkte.

Ako začať

Vytvorte si účet

Potvrďte e-mailovú adresu

Použite kľúč v aplikácii

Endpointy

Firmy

Služba a dokumentácia

Ako sa dáta udržiavajú

Import

Normalizácia

Indexácia

Synchronizácia