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

# Get Toplist Scopes

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

## 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}/scopes`
- Auth: HTTP bearer

Municipality or division scopes with a generated list for this metric.

Livestock and growth lists only exist for scopes above a size floor, so
the frontend builds its link grids from this instead of the full
municipality and division lists.

## Path parameters

- `metric` string, required

## Query parameters

- `scope_type` 'municipality' | 'division': Which scoped lists to enumerate

## Response `200`

Successful Response

- ToplistScopesResponse
  - `data` ToplistScopeSummary[], required
    - `code` string, required
    - `name` string, nullable
    - `name_en` string, nullable

## 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)