Spring til indhold

Grundfast

Største kommuner og postnumre

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

GET/v1/stats/top

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 · Åbent

Kræver ingen nøgle. Kaldet er begrænset pr. IP-adresse.

Afregning

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

Eksempel

curl "https://api.grundfast.dk/v1/stats/top?maal=bygninger&niveau=kommune&antal=3"
Svar · eksempel200
{
  "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"
  }
}

Parametre

maalstringqueryvalgfri
Hvad der tælles. Standard adresser.Værdier:adresserbygningerjordstykkerEksempel: bygninger
niveaustringqueryvalgfri
Kommuner eller postnumre. Standard kommune.Værdier:kommunepostnummerEksempel: kommune
antalintegerqueryvalgfri
Hvor mange rækker, 1–100. Standard 10.Eksempel: 3

Felter i svaret

raekker[]object[]
{ rang, kode, navn, vaerdi } — kode er kommunekoden eller postnummeret med fire cifre.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Ukendt maal eller niveau, antal uden for 1–100, eller jordstykker pr. postnummer.
429Mere end 60 kald i minuttet fra samme IP-adresse. Se Retry-After.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Åbent endpoint

Endpointet er åbent — kaldet sendes uden nøgle.

GET /v1/stats/top?maal=bygninger&niveau=kommune&antal=3

Bruges ofte sammen med