Spring til indhold

Grundfast

Optællinger pr. postnummer

Antallet af adresser og stående bygninger i hvert postnummer, uden nøgle.

GET/v1/stats/postnumre

Ét element pr. postnummer, sorteret efter postnummer. navn er postdistriktets navn, som adresseregistret staver det. Bygninger tælles efter den adresse, de har i BBR, så et postnummer uden adresser kan godt have bygninger.

Jordstykker er ikke med her: matriklen knytter dem til kommuner, ikke postnumre. Brug Optællinger pr. kommune til dem.

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/postnumre"
Svar · eksempel, forkortet200
{
  "opdateret": "2026-10-05",
  "antal": 1089,
  "postnumre": [
    {
      "postnr": "1050",
      "navn": "København K",
      "adresser": 39,
      "bygninger": 24
    },
    {
      "postnr": "2300",
      "navn": "København S",
      "adresser": 21193,
      "bygninger": 22647
    }
  ],
  "meta": {
    "kilde": "Grundfast (DAR-indeks, Matriklen jordstykker og BBR-bygningsindeks, lokalt)",
    "grundfast_version": "0.1.0"
  }
}

Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.

Felter i svaret

antalinteger
Antal postnumre i listen.
postnumre[]object[]
{ postnr, navn, adresser, bygninger } for hvert postnummer.

Statuskoder

StatusBetydning
200Svaret er leveret.
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/postnumre

Bruges ofte sammen med