> 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/endpoint-metrics.md).

# Endpoint metrics: overview of metrics

The metrics endpoint returns 55 metrics with several years of history in one API call: financials, vehicle fleet, employment, public contracts and more.

*Updated: 2 October 2026*

The `metrics` endpoint (`/{dataset}/v3/companies/{ico}/metrics`) returns 55 metrics with time series over several years in one call. It covers financial results, the vehicle fleet, employment, public contracts, subsidies and group data.

For the detailed specification (parameters, authentication, response format), see the [API documentation](https://developers.bizmachine.com/).

### Why this endpoint matters

The `metrics` endpoint is the most complete source of company data in a single API call. Unlike the other endpoints, which return only the current state, `metrics` contains **historical time series**: typically 5 to 8 years of financial data, 14 months of job postings *(as of July 2026)*, or 11 years of public contracts.

#### metrics vs aggregated-data

The `aggregated-data` endpoint contains a summary of about 25 metrics, but only the **latest known value** of each. The `metrics` endpoint is a superset: it returns the same metrics plus dozens more, with their full history.

|                       | aggregated-data  | metrics                                       |
| --------------------- | ---------------- | --------------------------------------------- |
| Number of metrics     | about 25         | 55                                            |
| Historical values     | no (latest only) | yes (several years)                           |
| Financial trends      | no               | yes (up to 8 years)                           |
| Vehicle fleet         | basic            | 14+ detailed metrics                          |
| Hiring and employment | basic            | monthly trends, 14 months *(as of July 2026)* |
| Public contracts      | no               | yearly series (up to 11 years)                |

> **Recommendation:** For any analysis that needs trends or comparisons over time, always use the `metrics` endpoint.

### Available metrics

The metrics are grouped by category below. Which metrics are available depends on the company: not every company has all the data.

#### Financial results (up to 8 years of history)

| Metric              | What it contains                                                                         |
| ------------------- | ---------------------------------------------------------------------------------------- |
| `revenue`           | Revenue (exact value or a band, depending on whether financial statements are available) |
| `ebitda`            | EBITDA                                                                                   |
| `ebit`              | EBIT (international definition, see the note below)                                      |
| `netProfit`         | Net profit                                                                               |
| `assetsTotal`       | Total assets                                                                             |
| `costOfGoodsSold`   | Cost of goods sold                                                                       |
| `personnelCost`     | Personnel costs                                                                          |
| `registeredCapital` | Registered capital                                                                       |

#### Financial ratios

| Metric                  | What it contains                     |
| ----------------------- | ------------------------------------ |
| `revenueGrowth`         | Year-on-year revenue growth          |
| `ebitMargin`            | EBIT margin                          |
| `netProfitMargin`       | Net profit margin                    |
| `capitalIntensityRatio` | Capital intensity (assets / revenue) |
| `valueAddedRatio`       | Value added ratio                    |
| `revenuePerEmployee`    | Revenue per employee                 |

#### Vehicle fleet (14+ metrics)

| Metric                             | What it contains                           |
| ---------------------------------- | ------------------------------------------ |
| `vehiclesOperatedTotal`            | Total number of vehicles operated          |
| `vehiclesOwnedTotal`               | Total number of vehicles owned             |
| `vehiclesOperatedPassenger`        | Passenger cars operated                    |
| `vehiclesOperatedUtility`          | Commercial vehicles operated               |
| `vehiclesOperatedElectric`         | Electric vehicles operated                 |
| `vehiclesOperatedPremium`          | Premium vehicles operated                  |
| `vehiclesRegistered12Months`       | Vehicles newly registered in the past year |
| `vehiclesRegistered12MonthsChange` | Year-on-year change in registrations       |
| `vehiclesTopBrand`                 | Most common brand in the fleet             |

> **Tip for financing analysis:** The difference `vehiclesOperatedTotal` minus `vehiclesOwnedTotal` shows how many vehicles are leased or financed by a loan. If a company operates 228 vehicles but owns only 40, the other 188 are probably financed.

#### Employment

| Metric                            | What it contains                            |
| --------------------------------- | ------------------------------------------- |
| `employees`                       | Number of employees (exact value or a band) |
| `employees12MonthsAvgGrowth`      | Average growth over the past year           |
| `employees24MonthsAvgGrowth`      | Average growth over the past two years      |
| `whiteCollar`                     | Share of office workers (0-1)               |
| `personnelMonthlyCostPerEmployee` | Average monthly personnel cost per employee |

#### Hiring (monthly time series)

| Metric                                 | What it contains                                    |
| -------------------------------------- | --------------------------------------------------- |
| `openJobCountCurrentTotal`             | Current open jobs                                   |
| `openJobCount12MonthsAverage`          | Average number of open jobs over the past year      |
| `openJobCountCurrentTo12MonthsAverage` | Current to average open jobs: shows hiring momentum |
| `openJobCountMonthly`                  | Monthly trend (14 periods) *(as of July 2026)*      |

> **How to read hiring momentum:** A ratio above 1.0 means the company is hiring faster than usual (growth). A ratio below 0.5 shows that hiring has slowed down significantly.

#### Public contracts (up to 11 years of history)

| Metric                                | What it contains                    |
| ------------------------------------- | ----------------------------------- |
| `publicContractsSupplierLast12Months` | Value of contracts in the past year |
| `publicContractsSupplierYearly`       | Yearly time series                  |

#### Subsidies

| Metric                           | What it contains                    |
| -------------------------------- | ----------------------------------- |
| `subsidiesRecipientLast12Months` | Subsidies received in the past year |
| `subsidiesRecipientYearly`       | Yearly time series                  |

#### Group and ownership

| Metric                                  | What it contains                       |
| --------------------------------------- | -------------------------------------- |
| `connectedCompaniesCount`               | Number of connected companies          |
| `connectedCompaniesAggregatedRevenues`  | Total revenue of the group             |
| `connectedCompaniesAggregatedEmployees` | Total number of employees in the group |
| `foreignOwnershipShare`                 | Share of foreign ownership             |
| `privateOwnershipShare`                 | Share of private ownership             |
| `publicOwnershipShare`                  | Share of public ownership              |
| `ownerAge`                              | Age of the owner (natural person)      |

#### Other

| Metric                      | What it contains                            |
| --------------------------- | ------------------------------------------- |
| `isExporter`                | Exporter flag                               |
| `isImporter`                | Importer flag                               |
| `locationCount`             | Number of business premises                 |
| `businessCardsCount`        | Number of entries in business directories   |
| `eshopCount`                | Number of e-shops                           |
| `riskCount`                 | Number of active risk signals               |
| `latestFinancialsAvailable` | Year of the latest available financial data |

### What to watch out for

#### EBIT: international vs Czech definition

The `ebit` metric in this endpoint uses the **international definition**: net profit + interest expense + income tax. Czech analysts, however, usually mean **operating profit** (Czech *provozní výsledek hospodaření*) when they say "EBIT". Operating profit excludes the whole financial result, not only interest.

For companies with large non-interest financial items (exchange rate differences, intercompany loans, investment income), the two values can differ a lot, sometimes even with the opposite sign. If you need the Czech operating profit, you can find it in the `financials` endpoint as a line of the financial statement.

#### Metrics may not be complete for every company

Some metrics apply only to certain types of companies, for example companies that run a vehicle fleet or work in agriculture. The API returns only the metrics it has data for. Do not expect every company to have all 55 metrics.

#### The `revenue` metric can have two types

If a company has published its financial statements, `revenue` contains the exact value. If not, it contains only an estimate as a band (for example "CZK 10-25 million"). Your code should handle both cases.

### Frequently asked questions

#### How many API calls does this use?

One call per company. All 55 metrics come in one response.

#### How often are the metrics updated?

It depends on the data source. Financial data is updated after financial statements are published. Vehicle fleet and employee data is updated continuously.

#### Do I still need the aggregated-data endpoint?

Yes. `aggregated-data` contains the basic company information (name, Company ID, NACE, contacts, indicators) that is not in `metrics`. For a complete view of a company, combine both endpoints.

### More information

* [Overview of API endpoints](/en/api-and-integrations/api-endpoints.md)
* [Bulk API calls](/en/api-and-integrations/bulk-api-calls.md)
* [Full API documentation](https://developers.bizmachine.com/)