# ARES Czech Business Register API

> ARES: every Czech company and institution by IČO or name, with address, legal form and NACE codes

- Vendor: `aresczechbusinessregisterapi` · version 1.0 · category Business · tags ares api, czech company api, ico lookup api, czech business register api, nace codes api, kyb api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/aresczechbusinessregisterapi
- This document: https://apiclay.com/docs/aresczechbusinessregisterapi.md
- OpenAPI 3.1: https://apiclay.com/api/aresczechbusinessregisterapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `aresczechbusinessregisterapi`
- Updated: 2026-11-18

## About

## ARES Czech Business Register API

ARES, the Czech Ministry of Finance's register of economic subjects: look up any company, sole trader or public body by its IČO, or search by name, place, legal form or NACE code, each with name, registered address and delivery address, legal form, founding and update dates, VAT number (DIČ), tax office, NACE activity codes, the source registers (commercial, trade, VAT and others) and their status.

Data comes from **ares.gov.cz** (https://ares.gov.cz). Every route calls the source's own public API and returns it unchanged.

Typical flow: POST `/search` with the sample body (change `obchodniJmeno`, `pocet`, `start`), then `/subject?ico=00177041`.

### Routes

#### POST `/search` - Search subjects
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| obchodniJmeno | body | string | no | Name or part of it, e.g. `skoda`. |
| ico | body | array | no | IČO numbers, e.g. `["00177041"]`. |
| pravniForma | body | array | no | Legal form codes, e.g. `["121"]` (joint-stock company). |
| czNace | body | array | no | NACE codes, e.g. `["29100"]`. |
| sidlo | body | object | no | Address filter, e.g. `{"kodObce": 554782}` (Prague). |
| pocet | body | number | no | Results per page, up to 100. |
| start | body | number | no | Results to skip. |

Returns: `pocetCelkem` and `ekonomickeSubjekty`: `ico`, `obchodniJmeno`, `sidlo` (address with `textovaAdresa`), `pravniForma`, `datumVzniku`, `datumAktualizace`, `dic`, `financniUrad`, `czNace`, `seznamRegistraci`, `primarniZdroj`.

#### GET `/subject` - Subject by IČO
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ico | path | string | yes | 8-digit IČO, e.g. `00177041` (Škoda Auto). |

Returns: The subject with every field of `/search` plus `adresaDorucovaci`, `dalsiUdaje`, `subRegistrSzr`.

### Caveats

- Sole traders appear under their own name and address, as the public register shows them.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by ares.gov.cz.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /search — Search subjects
- Gateway: `POST https://api.apiclay.com/v1/api/aresczechbusinessregisterapi/search`
- Body sample (JSON):

```json
{"obchodniJmeno": "skoda", "pocet": 5, "start": 0}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /subject — Subject by IČO
- Gateway: `GET https://api.apiclay.com/v1/api/aresczechbusinessregisterapi/subject`
- Public query params: `ico` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/aresczechbusinessregisterapi/search" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"obchodniJmeno": "skoda", "pocet": 5, "start": 0}'
```

Index of every published API: https://apiclay.com/llms.txt
