---
title: "Get Toplist"
method: GET
path: "/v1/reports/toplists/{metric}"
tags: ["internal"]
---

# Get Toplist

`GET /v1/reports/toplists/{metric}`

## Request

- Base URL: `https://api.companydata.dk` (the document declares no server; this is the origin it was published from)
- URL: `https://api.companydata.dk/v1/reports/toplists/{metric}`
- Auth: HTTP bearer

Top-100 company list for a metric, optionally scoped to a municipality,
an industry division or a curated industry group.

Served from the nightly-precomputed `toplists` collection; falls back to
a live query only when the combination has not been generated yet
(e.g. right after deploy, before the first generation run). Growth lists
and alias groups are never computed live: without a doc they are 404.

## Path parameters

- `metric` string, required

## Query parameters

- `municipality` string, nullable: Municipality code (e.g. 101)
- `division` string, nullable: Industry division code (2 digits, e.g. 62)
- `group` string, nullable: Curated industry group slug (e.g. banker), see /toplists/groups

## Response `200`

Successful Response

- ToplistResponse
  - `metric` string, required
  - `scope` ToplistScope, required
    - `type` string, required
    - `code` string, nullable
    - `name` string, nullable
    - `name_en` string, nullable
    - `name_plural` string, nullable
    - `name_plural_en` string, nullable
  - `entries` ToplistEntry[], required
    - `rank` integer, required
    - `cvr` string, required
    - `name` string, nullable, required
    - `founded_date` string, date-time, nullable
    - `revenue` integer, nullable
    - `employees` integer, nullable
    - `company_type` string, nullable
    - `industry_code` string, nullable
    - `industry_text` string, nullable
    - `municipality_code` string, nullable
    - `municipality_name` string, nullable
    - `animals` integer, nullable
    - `herds` integer, nullable
    - `revenue_growth` number, nullable
    - `size_value` integer, nullable
    - `size_basis` string, nullable
  - `count` integer, required
  - `generated_at` string, date-time, required
  - `available_metrics` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/companydata/apis/companydata-dk-api.md) · [All operations](https://skmtc.dev/companydata/apis/companydata-dk-api/llms.txt) · [OpenAPI document](https://skmtc.dev/companydata/apis/companydata-dk-api/revisions/1cc6c361ae64?raw)