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 -G "https://api.grundfast.dk/v1/stats/top" \
  --data-urlencode "maal=bygninger" \
  --data-urlencode "niveau=kommune" \
  --data-urlencode "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.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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