> 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/en/api-and-integrations/api-endpoints.md). # Overview of API endpoints Which BizMachine API endpoints exist, which version to use for each, how the two call types differ, and where to find the full specification. *Updated: 8 October 2026* The full technical specification of every endpoint (parameters, response format, examples) is in the [API documentation](https://developers.bizmachine.com/). This article helps you choose the right endpoint quickly: which one to use, in which version, and what to watch out for. ### Endpoint overview table The BizMachine API has endpoints in two versions, v3 and v4. Not every endpoint exists in both versions, and some return a different response format in each. The table shows the recommended version for each endpoint. | Endpoint | Version | Call type | What it returns | | ------------------------------------------------------------------------------------- | ------- | -------------- | ------------------------------------------------------------------------------------------------------- | | [aggregated-data](/en/api-and-integrations/api-endpoints/endpoint-aggregated-data.md) | **v4** | single-company | Basic information, contacts, indicators, NACE, a summary of metrics | | [metrics](/en/api-and-integrations/api-endpoints/endpoint-metrics.md) | **v3** | single-company | 55 metrics with time series over several years (financials, vehicle fleet, employees, public contracts) | | [suggest](/en/api-and-integrations/api-endpoints/endpoint-suggest.md) | **v4** | search | Finds a company by name, Company ID, VAT ID or domain and returns the Company ID for further calls | | `owners` | **v4** | single-company | Ownership structure with history and shares | | `connected-companies` | **v3** | single-company | Connected companies (parent companies, subsidiaries, links through statutory representatives) | | `risks` | **v4** | single-company | Risk signals (insolvency, enforcement proceedings, tax arrears) | | [contacts](/en/api-and-integrations/api-endpoints/endpoint-contacts.md) | **v4** | single-company | Phone, email, website, LinkedIn profiles of key people | | `financials` | **v3** | collection | Detailed financial statements (balance sheet, income statement) line by line | | `vehicles` | **v4** | collection | Vehicles with ownership chains, max. 250 records per page *(as of July 2026)* | | [events](/en/api-and-integrations/api-endpoints/endpoint-events.md) | **v3** | collection | Company events (changes in the business register, filings) | | `contracts` | **v3** | collection | Public contracts from the Czech Register of Contracts | | `subsidies` | **v3** | collection | Subsidies received | | `indicators` | **v3** | single-company | Detailed BizMachine indicators (Activity, Growth, Reachability) | | `statutories` | **v3** | collection | Statutory representatives (current and past) | | `job-postings` | **v3** | collection | Current job postings | | `locations` | **v3** | collection | Business premises and registered offices | | `bank-accounts` | **v4** | single-company | Registered bank accounts | | [eshops](/en/api-and-integrations/api-endpoints/endpoint-eshops.md) | **v3** | collection | Information about e-shops | > **Tip:** The `metrics` endpoint is probably the most useful single endpoint for company analysis. One call returns financial data, the vehicle fleet, employment and public contracts, with several years of history. See [Endpoint metrics: overview of metrics](/en/api-and-integrations/api-endpoints/endpoint-metrics.md). > **Note:** The table covers the endpoints that read company data. The full list, including endpoints for managing labels, search and other operations, is in the [API documentation](https://developers.bizmachine.com/). ### Two call types The API uses two call patterns. Which one applies depends on the endpoint. #### Single-company endpoints The Company ID goes directly into the URL path: ``` GET /{dataset}/v4/companies/{ico}/aggregated-data GET /{dataset}/v3/companies/{ico}/metrics ``` #### Collection endpoints The Company ID goes into a query parameter. Results can be paged: ``` GET /{dataset}/v3/events?Company.NationalIn={ico} GET /{dataset}/v3/financials/reports?Company.NationalIn={ico} ``` > **Exception: vehicles.** The `vehicles` endpoint does not use `Company.NationalIn`. It uses `Company.UniqueId` in the format `{dataset}-company-{ico}` (for example `cz-company-12345678`). If you use the wrong parameter, the API does not return an error. It returns unfiltered results. Details are in the [API documentation](https://developers.bizmachine.com/). ### Available datasets The BizMachine API covers five markets *(as of July 2026)*. The dataset goes directly into the URL: | Dataset | Market | | ------- | -------------- | | `cz` | Czech Republic | | `sk` | Slovakia | | `hu` | Hungary | | `pl` | Poland | | `de` | Germany | > **Note:** The range of available data differs between countries. Coverage is widest for the Czech Republic and Slovakia. ### Response language You can set the language of the data in responses with the `Accept-Language` header. The default is English. | Value | Language | | ----- | ----------------- | | `EN` | English (default) | | `CS` | Czech | | `SK` | Slovak | ### Authentication Every API request must include a header with your API key: ``` X-Api-Key: {YOUR_API_KEY} ``` To create an API key, see [How do I generate an API key?](/en/api-and-integrations/generating-an-api-key.md). ### What to watch out for A few things that save time during an integration: * **v3 vs v4:** not every endpoint works in both versions. The table above shows the recommended version. If an endpoint does not exist in the version you call, the API returns `UnsupportedApiVersion`. * **Paging:** collection endpoints return 200 records per page by default, and up to 250 with the `Limit` parameter *(as of October 2026)*. To get further pages, use the `Offset` parameter (not `Page`). `Offset` must be a multiple of the page size. See [Bulk API calls](/en/api-and-integrations/bulk-api-calls.md). * **Unknown parameters:** the API silently ignores query parameters it does not know and returns unfiltered results. If you get an unexpectedly large number of records, check that the parameter names are correct. * **metrics vs aggregated-data:** `aggregated-data` contains a summary of about 25 metrics (latest values only). The separate `metrics` endpoint returns 55 metrics with their full history over several years. See [Endpoint metrics: overview of metrics](/en/api-and-integrations/api-endpoints/endpoint-metrics.md). ### More information * [How do I generate an API key?](/en/api-and-integrations/generating-an-api-key.md) * [What is an integration account?](/en/api-and-integrations/integration-account.md) * [What are my API limits?](/en/api-and-integrations/api-limits.md) * [Bulk API calls](/en/api-and-integrations/bulk-api-calls.md) * [Endpoint metrics: overview of metrics](/en/api-and-integrations/api-endpoints/endpoint-metrics.md) * [Full API documentation](https://developers.bizmachine.com/)