# EuroKYB REST API

Read supplier checks from an accounting system or script. The API returns JSON. Its OpenAPI file lists the routes for Czech companies, EU VAT, IBAN, exchange rates, payment QR data and public web pages.

![A company ID passes through a registry lookup and becomes named fields in a JSON response.](https://alertviz.com/hub/guides/eurokyb-api/en.png)

## How to use it

1. Set the base address as shown below. Read `/v1/quota` to see `remaining` and `resetsAt`. This status request costs no checks.
2. Call `/v1/cz/kyb` with the company ID as text. To use a subscription, send the key in the `X-API-Key` header. Keep it in your server configuration or credential store.
3. Read both the HTTP status and the response body. For 429, wait for the time in `Retry-After`. For 401, check the key and its expiry.

## Try it

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

## Reading the result

Compare `companyName` and `publishedBankAccounts` with the invoice. UNKNOWN means more verification is needed. New Pro keys include 1,000 completed checks per month. Business includes 5,000. Both allow up to 300 per minute.

[Open the tool](https://alertviz.com/eurokyb/openapi.json)
