> For the complete documentation index, see [llms.txt](https://help.bizmachine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.bizmachine.com/api-a-integrace/api-endpointy.md). # Přehled API endpointů *Aktualizováno: 8. dubna 2026* ## Přehled API endpointů Kompletní technická specifikace endpointů (parametry, formát odpovědí, příklady) je v [API dokumentaci](http://developers.bizmachine.com/). Tento článek vám pomůže se v endpointech rychle zorientovat — který použít, v jaké verzi a na co si dát pozor. ### Přehledová tabulka endpointů BizMachine API obsahuje endpointy ve dvou verzích (v3 a v4). Ne každý endpoint je dostupný v obou verzích a některé se ve formátu odpovědi liší. Tabulka níže shrnuje doporučenou verzi pro každý endpoint. | Endpoint | Verze | Typ volání | Co vrací | | ----------------------------------------------------------------------------- | ------ | ------------ | -------------------------------------------------------------------------------------------- | | [aggregated-data](/api-a-integrace/api-endpointy/endpoint-aggregated-data.md) | **v4** | jednofirmové | Základní info, kontakty, indikátory, NACE, souhrn metrik | | [metrics](/api-a-integrace/api-endpointy/endpoint-metrics.md) | **v3** | jednofirmové | 55 metrik s víceletými časovými řadami (finance, vozový park, zaměstnanci, veřejné zakázky) | | [suggest](/api-a-integrace/api-endpointy/endpoint-suggest.md) | **v4** | vyhledávání | Vyhledání firmy podle názvu, IČO, DIČ nebo domény — vrátí IČO pro použití v dalších voláních | | `owners` | **v4** | jednofirmové | Vlastnická struktura s historií a podíly | | `connected-companies` | **v3** | jednofirmové | Propojené firmy (mateřské, dceřiné, přes statutáry) | | `risks` | **v4** | jednofirmové | Rizikové signály (insolvence, exekuce, daňové nedoplatky) | | [contacts](/api-a-integrace/api-endpointy/endpoint-contacts.md) | **v4** | jednofirmové | Telefon, e-mail, web, LinkedIn profily klíčových osob | | `financials` | **v3** | kolekce | Detailní účetní výkazy (rozvaha, výsledovka) po řádcích | | `vehicles` | **v4** | kolekce | Vozidla s vlastnickými řetězci, stránkováno po 250 | | [events](/api-a-integrace/api-endpointy/endpoint-events.md) | **v3** | kolekce | Firemní události (změny v rejstříku, podání) | | `contracts` | **v3** | kolekce | Veřejné zakázky z Registru smluv | | `subsidies` | **v3** | kolekce | Přijaté dotace | | `indicators` | **v3** | jednofirmové | Detailní BizMachine indikátory (aktivita, růst, dosažitelnost) | | `statutories` | **v3** | kolekce | Statutární zástupci (aktuální i historičtí) | | `job-postings` | **v3** | kolekce | Aktuální pracovní nabídky | | `locations` | **v3** | kolekce | Provozovny a sídla | | `bank-accounts` | **v4** | jednofirmové | Registrované bankovní účty | | [eshops](/api-a-integrace/api-endpointy/endpoint-eshops.md) | **v3** | kolekce | Informace o eshopech | > **Tip:** Endpoint `metrics` je pravděpodobně nejhodnotnější jednotlivý endpoint pro firemní analýzu — kombinuje finanční data, vozový park, zaměstnanost i veřejné zakázky v jednom volání s víceletou historií. Viz [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md). > **Poznámka:** Tabulka pokrývá datové endpointy pro čtení firemních údajů. Kompletní seznam včetně endpointů pro správu štítků, vyhledávání a dalších operací najdete v [API dokumentaci](http://developers.bizmachine.com/). ### Dva typy volání API rozlišuje dva vzory volání. Typ závisí na konkrétním endpointu: #### Jednofirmové endpointy IČO se předává přímo v URL cestě: ``` GET /{dataset}/v4/companies/{ico}/aggregated-data GET /{dataset}/v3/companies/{ico}/metrics ``` #### Kolekční endpointy IČO se předává jako query parametr. Výsledky mohou být stránkované: ``` GET /{dataset}/v3/events?Company.NationalIn={ico} GET /{dataset}/v3/financials/reports?Company.NationalIn={ico} ``` > **Pozor — vozidla jsou výjimka:** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (například `cz-company-12345678`). Pokud použijete špatný parametr, API nevrátí chybu — vrátí nefiltrované výsledky. Podrobnosti v [API dokumentaci](http://developers.bizmachine.com/). ### Dostupné datové sady BizMachine API pokrývá pět trhů. Dataset se předává přímo v URL: | Dataset | Trh | | ------- | --------------- | | `cz` | Česká republika | | `sk` | Slovensko | | `hu` | Maďarsko | | `pl` | Polsko | | `de` | Německo | > **Poznámka:** Šíře dostupných dat se mezi zeměmi liší. Nejbohatší datové pokrytí nabízíme pro Českou republiku a Slovensko. ### Jazyk odpovědí Jazyk dat v odpovědích lze ovlivnit hlavičkou `Accept-Language`. Výchozí jazyk je angličtina. | Hodnota | Jazyk | | ------- | -------------------- | | `EN` | Angličtina (výchozí) | | `CS` | Čeština | | `SK` | Slovenština | ### Autentizace Každý API dotaz musí obsahovat hlavičku s vaším API klíčem: ``` X-Api-Key: {VÁŠ_API_KLÍČ} ``` Jak API klíč vygenerovat: [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md) ### Na co si dát pozor Několik věcí, které při integraci ušetří čas: * **v3 vs v4** — ne každý endpoint funguje v obou verzích. Tabulka výše ukazuje doporučenou verzi. Pokud endpoint ve zvolené verzi neexistuje, API vrátí `UnsupportedApiVersion`. * **Stránkování** — kolekční endpointy vracejí max 250 záznamů na stránku. K dalším stránkám se dostanete parametrem `Offset` (ne `Page`). Viz [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani.md). * **Neznámé parametry** — API tiše ignoruje neznámé query parametry a vrátí nefiltrované výsledky. Pokud dostáváte neočekávaně velký počet záznamů, zkontrolujte správnost názvů parametrů. * **Metriky vs aggregated-data** — `aggregated-data` obsahuje souhrn \~25 metrik (poslední hodnoty). Samostatný endpoint `metrics` vrací 55 metrik s kompletní víceletou historií. Podrobnosti viz [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md). ### Další informace * [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md) * [Co je to integrační účet?](/api-a-integrace/integracni-ucet.md) * [Jaké jsou moje API limity?](/api-a-integrace/api-limity.md) * [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani.md) * [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md) * [Kompletní API dokumentace](http://developers.bizmachine.com/)