# Største kommuner og postnumre

`GET /v1/stats/top` · Åbne endpoints

De kommuner eller postnumre, der har flest adresser, bygninger eller jordstykker — rangeret, uden nøgle.

Vælg hvad der tælles med `maal` og hvad der rangeres med `niveau`. Ved lige store tal går den laveste kode først, så rækkefølgen er den samme fra kald til kald.

Jordstykker kan kun rangeres pr. kommune; `maal=jordstykker&niveau=postnummer` giver 400.

**Godkendelse:** Ingen — åbent endpoint

**Afregning:** Gratis og uden nøgle; begrænset til 60 kald i minuttet pr. IP-adresse.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `maal` | query | string | nej | Hvad der tælles. Standard `adresser`. |
| `niveau` | query | string | nej | Kommuner eller postnumre. Standard `kommune`. |
| `antal` | query | integer | nej | Hvor mange rækker, 1–100. Standard 10. |

## Eksempel

```bash
curl "https://api.grundfast.dk/v1/stats/top?maal=bygninger&niveau=kommune&antal=3"
```

## Svar (200)

```json
{
  "maal": "bygninger",
  "niveau": "kommune",
  "opdateret": "2026-10-05",
  "raekker": [
    {
      "rang": 1,
      "kode": "0751",
      "navn": "Aarhus",
      "vaerdi": 164548
    },
    {
      "rang": 2,
      "kode": "0851",
      "navn": "Aalborg",
      "vaerdi": 150111
    },
    {
      "rang": 3,
      "kode": "0461",
      "navn": "Odense",
      "vaerdi": 125986
    }
  ],
  "meta": {
    "kilde": "Grundfast (DAR-indeks, Matriklen jordstykker og BBR-bygningsindeks, lokalt)",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `raekker[]` | object[] | `{ rang, kode, navn, vaerdi }` — `kode` er kommunekoden eller postnummeret med fire cifre. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Ukendt `maal` eller `niveau`, `antal` uden for 1–100, eller jordstykker pr. postnummer. |
| 429 | Mere end 60 kald i minuttet fra samme IP-adresse. Se `Retry-After`. |