Spring til indhold

Grundfast

Landstotaler

Hvor mange adresser, enhedsadresser, jordstykker, bygninger, kommuner og postnumre Grundfast har data for — i ét kald, uden nøgle.

GET/v1/stats/totals

Tallene er optællinger over de datasæt, Grundfast selv har liggende: adresseindekset fra DAR, matriklens jordstykker og det nationale bygningsindeks fra BBR. bygninger tæller stående bygninger (status opført). De opdateres med de daglige kørsler, og svaret må caches i en time.

Brug det til at vise dækning i dit eget produkt, eller til at kontrollere, at et udtræk er komplet.

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/totals"
Svar · eksempel200
{
  "opdateret": "2026-10-05",
  "adresser": 2704406,
  "enheder": 4166594,
  "jordstykker": 2567547,
  "bygninger": 4844558,
  "kommuner": 99,
  "postnumre": 1089,
  "meta": {
    "kilde": "Grundfast (DAR-indeks, Matriklen jordstykker og BBR-bygningsindeks, lokalt)",
    "grundfast_version": "0.1.0"
  }
}

Felter i svaret

adresserinteger
Adgangsadresser (DAR).
enhederinteger
Enhedsadresser med etage og dør (DAR Adresse).
jordstykkerinteger
Jordstykker i matriklen.
bygningerinteger
Stående bygninger i BBR (status opført).
kommunerinteger
Kommuner med adresser.
postnumreinteger
Postnumre med adresser.

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/totals

Bruges ofte sammen med