API

REST API Chytrého Rejstříku nabízí snadný přístup k datům o firmách a podnikatelích. Kombinuje data z desítek zdrojů. K dispozici jsou základní data o subjektu, statistická data o obratu a počtu zaměstnanců, souhrný přehled o vozovém parku, dotacích a pobočkách, finanční výsledky, stav DPH, kritické rizikové signály, statutární orgány a odkazy na detail a sbírku listin.

Základní limit pro volání je 50 požadavků za minutu nebo 500 požadavků za den. Maximálně 2 souběžné požadavky.

Autorizace probíhá pomocí tokenu, v HTTP hlavičce Authorization.

Doporučujeme posílat hlavičku Accept: application/json, pro správnou odpověď ve formátu JSON.

API token

Authorization: Bearer API_TOKEN

Souhrn o firmě pro snadnou prověrku firmy. Obsahuje základní data, sídlo, statistické údaje, finanční výsledky, DPH, rizika, dostupné kontakty a URL na detail firmy na Chytryrejstrik.cz i na sbírku listin.

Volání

https://api.chytryrejstrik.cz/v1/profil/ICO

ICO je IČ subjektu, číselná hodnota max. 8 znaků

Hodnoty odpovědi

data.zakladni

data.zakladni.stav Stav subjektu (Aktivní, Neaktivní, V insolvenci, V konkursu, V likvidaci, S reorganizací, Vymazaná)

data.zakladni.ico IČO

data.zakladni.dic DIČ (pokud existuje)

data.zakladni.nazev Název subjektu

data.zakladni.pravni_forma Právní forma

data.zakladni.vznik Datum vzniku (YYYY-MM-DD)

data.zakladni.cz_nace.obor CZ-NACE obor

data.zakladni.cz_nace.podobor CZ-NACE podobor

data.zakladni.cz_nace.kod CZ-NACE kód

data.sidlo

data.sidlo.stat Stát (kód)

data.sidlo.obec Obec

data.sidlo.ulice Ulice

data.sidlo.cislo_domovni Číslo domovní

data.sidlo.cislo_orientacni Číslo orientační

data.sidlo.psc PSČ

data.prehled

data.prehled.obrat Kategorie obratu

data.prehled.zamestnanci Kategorie počtu zaměstnanců

data.prehled.pobocky Počet poboček

data.prehled.vozidla Počet aktivních vozidel

data.prehled.smlouvy Počet smluv

data.prehled.dotace Počet dotací

data.finance

data.finance.zakladni_kapital Základní kapitál v CZK

data.finance.aktiva Aktiva z poslední závěrky v celých CZK

data.finance.trzby Tržby v celých CZK

data.finance.zisk Zisk v celých CZK

data.finance.celkova_zadluzenost Celková zadluženost

data.dph

data.dph.aktivni_dph Aktivní DPH (true/false)

data.dph.typ_platce Typ plátce DPH (spolehlivy_platce, nespolehlivy_platce, identifikovana_osoba, neplatce, neznamy)

data.dph.kontrola_dph Poslední datum kontroly DPH

data.rizika

data.rizika.insolvencni_zaznam Insolvenční záznam

data.rizika.platnost_dph Platnost DPH

data.rizika.exekucni_zaznam Exekuční záznam

data.rizika.zaporny_vlastni_kapital Záporný vlastní kapitál

data.rizika.rejstrik_trestu Rejstřík trestů

data.rizika.rizikova_osoba Riziková osoba ve vedení

data.rizika.zivnost_neaktivni Živnost neaktivní

data.kontakt

data.kontakt.datova_schranka Datová schránka

data.kontakt.web Web

data.kontakt.vedeni_jmeno Vedení – jméno

data.kontakt.vedeni_pozice Vedení – pozice

data.kontakt.vedeni_email Vedení – e-mail

data.kontakt.vedeni_telefon Vedení – telefon

data.kontakt.obecne_jmeno Obecné – jméno

data.kontakt.obecne_pozice Obecné – pozice

data.kontakt.obecne_email Obecné – e-mail

data.kontakt.obecne_telefon Obecné – telefon

data.kontakt.statutari Aktuální statutáři (pole)

data.url

data.url.detail URL detailu Chytryrejstrik.cz

data.url.sbirka_listin URL detailu sbírky listin

Struktura odpovědi

{
  "kod": number,
  "data": {
    "zakladni": {
      "stav": string,
      "ico": string,
      "dic": string|null,
      "nazev": string,
      "pravni_forma": string,
      "vznik": string, // YYYY-MM-DD
      "cz_nace": {
        "obor": string|null,
        "podobor": string|null,
        "kod": string|null
      }
    },
    "sidlo": {
      "stat": string|null,
      "obec": string|null,
      "ulice": string|null,
      "cislo_domovni": string|null,
      "cislo_orientacni": string|null,
      "psc": string|null
    },
    "prehled": {
      "obrat": string|null,
      "zamestnanci": string|null,
      "pobocky": number,
      "vozidla": number,
      "smlouvy": number,
      "dotace": number
    },
    "finance": {
      "zakladni_kapital": number|null,
      "aktiva": number|null,
      "trzby": number|null,
      "zisk": number|null,
      "celkova_zadluzenost": number|null
    },
    "dph": {
      "aktivni_dph": boolean,
      "typ_platce": string,
      "kontrola_dph": string
    },
    "rizika": {
      "insolvencni_zaznam": boolean,
      "platnost_dph": boolean,
      "exekucni_zaznam": boolean,
      "zaporny_vlastni_kapital": boolean,
      "rejstrik_trestu": boolean,
      "rizikova_osoba": boolean,
      "zivnost_neaktivni": boolean
    },
    "kontakt": {
      "datova_schranka": string|null,
      "web": string|null,
      "vedeni_jmeno": string|null,
      "vedeni_pozice": string|null,
      "vedeni_email": string|null,
      "vedeni_telefon": string|null,
      "obecne_jmeno": string|null,
      "obecne_pozice": string|null,
      "obecne_email": string|null,
      "obecne_telefon": string|null,
      "statutari": string|empty[]
    },
    "url": {
      "detail": string,
      "sbirka_listin": string|null
    }
  }
}

V odpovědi je vždy uveden kod. Úspěšná odpověď obsahuje data, neúspěšná error.

200 – Úspěch

400 – Neplatný vstup

401 – Neplatný nebo chybějící token

404 – Subjekt nenalezen

429 – Překročen limit požadavků (za minutu / za den / souběžných)

500 – Server error

Ukázka CURL volání:

 curl --request GET \
 --url "https://api.chytryrejstrik.cz/v1/profil/27082440" \
 --header "Authorization: Bearer API_TOKEN" \
 --header "Accept: application/json"

API_TOKEN najdete ve svém účtu v části API přístup .

Ukázka odpovědi:

{
  "kod": 200,
  "data": {
    "zakladni": {
      "stav": "Aktivní",
      "ico": "27082440",
      "dic": "CZ27082440",
      "nazev": "Alza.cz a.s.",
      "pravni_forma": "Akciová společnost",
      "vznik": "2003-08-26",
      "cz_nace": {
        "obor": "Maloobchod, kromě motorových vozidel",
        "podobor": "Maloobchod prostřednictvím internetu",
        "kod": "47911"
      }
    },
    "sidlo": {
      "stat": "CZ",
      "obec": "Praha",
      "ulice": "Jankovcova",
      "cislo_domovni": "1522",
      "cislo_orientacni": "53",
      "psc": "17000"
    },
    "prehled": {
      "obrat": "1,5 mld.+",
      "zamestnanci": "2500 - 2999 zaměstnanců",
      "pobocky": 126,
      "vozidla": 200,
      "smlouvy": 6782,
      "dotace": 0
    },
    "finance": {
      "zakladni_kapital": 2000000,
      "aktiva": 17842000000,
      "trzby": 61074000000,
      "zisk": 2297000000,
      "celkova_zadluzenost": 82.7
    },
    "dph": {
      "aktivni_dph": true,
      "typ_platce": "spolehlivy",
      "kontrola_dph": "2026-02-18"
    },
    "rizika": {
      "insolvencni_zaznam": false,
      "platnost_dph": false,
      "exekucni_zaznam": false,
      "zaporny_vlastni_kapital": false,
      "rejstrik_trestu": false,
      "rizikova_osoba": false,
      "zivnost_neaktivni": false
    },
    "kontakt": {
      "datova_schranka": "xtkcrkz",
      "web": "alza.cz",
      "vedeni_jmeno": "",
      "vedeni_pozice": "",
      "vedeni_email": "",
      "vedeni_telefon": "",
      "obecne_jmeno": "Adam Ukázkový",
      "obecne_pozice": "HR",
      "obecne_email": "adam.ukazkovy@alza.cz",
      "obecne_telefon": "",
      "statutari": [
        "Aleš Zavoral - Předseda představenstva",
        "Miroslav Köváry - Místopředseda představenstva",
        "Jakub Krejčíř - Místopředseda představenstva",
        "Ing. Hana Žáková Petrová - Člen dozorčí rady",
        "Petr Hošek - Člen dozorčí rady",
        "L.S. INVESTMENTS LIMITED",
        "Ing. Petr Bena - Místopředseda představenstva",
        "Jan Moudřík - Předseda dozorčí rady"
      ]
    },
    "url": {
      "detail": "https://www.chytryrejstrik.cz/ico-27082440/alza-cz-a-s",
      "sbirka_listin": "https://or.justice.cz/ias/ui/vypis-sl-firma?subjektId=701502"
    }
  }
}

Objednat přístup si můžete ihned na stránce ceníku.

V záložce "API přístup" ve svém účtu najdete po platbě token. Token zde můžete regenerovat a zjistíte zde i poslední přístup.

Pokud potřebujete navýšit limit na API, kontaktujte nás.