ARES nabízí bezplatné REST API. Tento průvodce poctivě ukazuje, kdy stačí ono a kdy se hodí jednotné schéma pro veřejný rejstřík i další země, s monitoringem.
ARES, Administrativní registr ekonomických subjektů Ministerstva financí, nabízí bezplatné REST API, které nevyžaduje klíč. Pokud potřebujete jen základní údaje o jedné české firmě podle IČO, je to nejlevnější cesta a nemusíte hledat dál.
Prometiam vrací veřejný rejstřík ve stejném schématu jako dalších 28 zemí a přidává to, co samotný dotaz do registru neřeší: jednotná pole napříč zeměmi (měníte jen parametr country), monitoring s webhooky podepsanými HMAC-SHA256 a události změn v rejstříku. Hodí se, když ověřujete české firmy spolu s protistranami z Německa, Polska či Slovenska a nechcete psát integraci pro každý registr zvlášť.
Vyhledávání pro Česko přijímá IČO (company_number) nebo obchodní název (name). IČO má osm číslic; kontrolní číslice (modulo 11) je jen orientační, protože v rejstříku jsou živé firmy, jejichž IČO jí neodpovídá, a ty se vracejí také. Výsledky jsou v poli data.
# Podle IČO (ČEZ, a. s.)
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CZ&company_number=45274649' \
-H 'Authorization: Bearer rk_live_...'
# Celý záznam podle id z odpovědi
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/{id}' \
-H 'Authorization: Bearer rk_live_...'
import os, requests
API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}
def firma_podle_ico(ico: str):
r = requests.get(f'{API}/companies/search',
params={'country': 'CZ', 'company_number': ico}, headers=HEAD)
r.raise_for_status()
data = r.json()['data']
return data[0] if data else None
print(firma_podle_ico('45274649')['company_name'])
| Pole | Co znamená |
|---|---|
company_name | Obchodní firma zapsaná v rejstříku |
company_number | IČO, osmimístné identifikační číslo osoby |
status | Standardizovaný stav (i likvidace, insolvence, konkurs a reorganizace) |
local_status | Stav tak, jak ho uvádí rejstřík |
legal_form / local_legal_form | Právní forma, standardizovaná a v českém znění rejstříku |
founding_date | Datum vzniku |
| adresa | Sídlo: ulice, obec, PSČ a kraj |
share_capital | Základní kapitál, jak je zapsán v rejstříku |
activity_code | Kód hlavní činnosti CZ-NACE 2025 z Registru ekonomických subjektů (ČSÚ) |
registry_details | Rejstříkový soud a spisová značka (například B 1581, Městský soud v Praze) |
Každý požadavek nese hlavičku Authorization: Bearer rk_live_.... Limity za minutu podle tarifu: Starter 60, Professional 120, Scale 300. Odpověď nese hlavičku X-Credits-Cost: vyhledání firmy i načtení záznamu stojí po jednom kreditu, chyby jsou zdarma. Dávkové volání (POST /companies/lookup) počítá každou položku jako jeden požadavek.
vat= pro Česko API odmítne.Přes POST /monitor s {"company_id": ..., "country": "CZ"} sledujete firmu a dostanete webhook při změně stavu, zániku, shodě se sankčním seznamem (beta) a události v rejstříku. Webhooky vyžadují tarif Professional (29,99 EUR, 10 000 kreditů, 250 sledovaných firem).
Obsahuje data z veřejných rejstříků České republiky (Ministerstvo spravedlnosti, otevřená data ISVR) a Českého statistického úřadu (RES, CC BY 4.0). Upraveno společností Prometiam. Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam.
Začněte 14denní zkušební období · Dokumentace API
Zkušební období trvá 14 dní a zahrnuje 500 kreditů. Vyžaduje se platební karta, během zkušebního období se nic neúčtuje; poté pokračuje tarif Starter (9,99 EUR měsíčně), pokud jej nezrušíte.