# EuroKYB REST API

Načtěte ověření přímo do účetního programu nebo skriptu. Služba vrací JSON. Ze seznamu cest v OpenAPI můžete vybrat českou firmu, evropské DIČ, IBAN, kurz ČNB, platební QR nebo kontrolu veřejné stránky.

![Příklad toku od dotazu na IČO přes registr až k polím ve výsledném JSON.](https://alertviz.com/hub/guides/eurokyb-api/cs.png)

## Postup

1. V terminálu nastavte základní adresu jako v příkladu. Požadavkem na `/v1/quota` si zdarma přečtěte `remaining` (zbývající počet) a `resetsAt` (obnovení limitu).
2. Zavolejte `/v1/cz/kyb` s IČO jako textem. U klíče předplatného přidejte hlavičku `X-API-Key` se svým klíčem. Uchovávejte jej na serveru nebo v úložišti přihlašovacích údajů.
3. Zpracujte stav HTTP i obsah odpovědi. U 429 počkejte podle hlavičky `Retry-After`. Při 401 zkontrolujte platnost klíče.

## Vyzkoušejte

```sh
BASE=https://alertviz.com/api/eurokyb
curl -sS "$BASE/v1/quota"
curl -sS "$BASE/v1/cz/kyb?ico=00094943"
```

## Jak číst výsledek

Ve výpisu porovnejte `companyName` a `publishedBankAccounts` s fakturou. Stav UNKNOWN vyžaduje další ověření. Nové klíče Pro zahrnují 1 000 dokončených kontrol měsíčně, Business 5 000. Oba tarify mají strop 300 za minutu.

[Otevřít nástroj](https://alertviz.com/eurokyb/openapi.json)
