> 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/hromadne-api-volani.md).

# Hromadné (BULK) API volání

*Aktualizováno: 12. března 2026*

## Hromadné (BULK) API volání

Vybrané API endpointy (kolekční endpointy) podporují hromadné volání — můžete jedním dotazem získat data pro více firem najednou. Kompletní přehled endpointů a parametrů najdete v [API dokumentaci](http://developers.bizmachine.com/).

### Stránkování výsledků

API vrací maximálně **250 záznamů na stránku**. K dalším stránkám se dostanete parametrem `Offset`:

```
GET /cz/v3/events?Company.NationalIn=12345678&Offset=0      (1. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Offset=250    (2. stránka)
GET /cz/v3/events?Company.NationalIn=12345678&Offset=500    (3. stránka)
```

Celkový počet záznamů najdete v odpovědi v poli `paging.totalItems`. Stránkujte, dokud nezpracujete všechny záznamy.

> **Pozor:** Používejte parametr `Offset`, ne `Page`. Parametr `Page` API tiše ignoruje a vrací stále první stránku — výsledkem jsou duplicitní data bez jakékoliv chybové hlášky.

### Nejčastěji používané parametry

#### Tag.UID — filtrování podle štítku

API vrátí data pouze pro firmy v zadaném štítku (seznamu). Štítek můžete vytvořit přímo v Prospectoru jako "Seznam firem", nebo ho spravovat kompletně přes API.

Typický postup: přes API nahrajte seznam firem do štítku a pak provolejte libovolný datový endpoint s parametrem `Tag.UID` — dostanete data jen pro tyto firmy.

#### Updated.From, Updated.To — inkrementální aktualizace

API vrátí pouze záznamy změněné ve sledovaném období. Typicky stačí jednorázově naimportovat všechna data a pak pravidelně dotazovat jen přírůstek za poslední období.

### Na co si dát pozor

* **Neznámé parametry API tiše ignoruje.** Pokud použijete špatný název parametru (překlep, nesprávný formát), API nevrátí chybu — vrátí nefiltrované výsledky. Když dostáváte neočekávaně velký počet záznamů, zkontrolujte názvy parametrů.
* **Vozidla používají jiný identifikátor.** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (např. `cz-company-12345678`). Podrobnosti viz [Přehled API endpointů](/api-a-integrace/api-endpointy.md).
* **Limit 250 na stránku platí pro všechny kolekční endpointy.** Tato hodnota (`maxPageSize`) je uvedena v odpovědi v sekci `paging`.

### Další informace

* [Přehled API endpointů](/api-a-integrace/api-endpointy.md)
* [Jaké jsou moje API limity?](/api-a-integrace/api-limity.md)
* [API dokumentace](http://developers.bizmachine.com/)