---
title: "Súhrny podľa rozmeru (?by=nace|nace_eu_section|nace_eu_division|region|size|country|municipality|shell_density|entity_type|nuts2|nuts3|licensed_type|...)"
method: GET
path: "/api/v1/companies/stats/breakdown"
tags: ["companies"]
---

# Súhrny podľa rozmeru (?by=nace|nace_eu_section|nace_eu_division|region|size|country|municipality|shell_density|entity_type|nuts2|nuts3|licensed_type|...)

`GET /api/v1/companies/stats/breakdown`

## Request

- Base URL: `https://entyrix.com`
- URL: `https://entyrix.com/api/v1/companies/stats/breakdown`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Query parameters

- `by` 'nace' | 'nace_eu_section' | 'nace_eu_division' | 'region' | 'size' | 'security' | 'country' | 'mx_provider' | 'ssl_issuer' | 'tech_stack' | 'nis2_category' | 'nis2_sector' | 'credit_grade' | 'municipality' | 'shell_density' | 'entity_type' | 'nuts2' | 'nuts3' | 'licensed_type' | 'email_auth_tier' | 'tls_ca_tier' | 'cyber_band' | 'domain_distress_level', required
- `country` 'sk' | 'cz' | 'all'
- `limit` string
- `active_only` string
- `refresh` string

## Response `200`

Úspešná odpoveď

- object
  - `data` unknown
  - `meta` object
    - `duration_ms` integer: Čas spracovania požiadavky v ms
    - `cached` boolean: True ak odpoveď pochádza z cache
    - `request_id` string: Request ID pre tracing

## Other responses

- `401`: Missing or invalid auth
- `429`: Rate limited (`RATE_LIMITED`) — per-key plan limit in a fixed 60 s window (Free 120/min; see /pricing) or the shared limiter (~600/min per IP without a key; per key ~600 or the plan limit when higher); only the shared layer sends Retry-After. Or quota exhausted (`QUOTA_EXCEEDED`) — monthly request quota per plan (Free 1,000 · Pro 250,000 · Business 2,000,000) or the fixed budget of a day/week pass; carries `Retry-After` and `X-Quota-*` headers. See /llms.txt and /pricing.
- `500`: Internal error

---

[API](https://skmtc.dev/entyrix/apis/entyrix-api.md) · [All operations](https://skmtc.dev/entyrix/apis/entyrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entyrix/apis/entyrix-api/revisions/2af4164275e9?raw)