Spring til indhold

Grundfast

Hent en kodeliste

En oversat BBR-kodeliste med alle koder og deres danske tekst, fx til dropdowns og filtre.

GET/v1/kodeliste/{navn}

Svaret er listen, som API’et selv bruger til at oversætte kodefelter i ejendomssvaret: hver kode som { kode, tekst }. Brug den, når du vil vise alle mulige værdier — fx alle varmeinstallationer i et filter — frem for kun dem, du tilfældigvis har set.

Koderne er strenge, præcis som i ejendomssvaret, fx "1" for "Fjernvarme/blokvarme". Endpointet kræver ingen nøgle og tæller ikke mod kvoten.

Ud over de syv lister herunder svarer endpointet også på afvigendeetager, etagetype og tekniskanlaegklassifikation, som oversætter etage- og anlægsfelterne. De tre er ikke med i SDK’ens KodelisteNavn-type.

branchekode er ikke en BBR-liste, men Dansk Branchekode 2025 (DB25) fra Danmarks Statistik: de 738 sekscifrede branchekoder uden punktummer, fx "841300", præcis som de står i branche.kode på CVR-opslaget.

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/kodeliste/varmeinstallation"
Svar · eksempel200
{
  "navn": "varmeinstallation",
  "koder": [
    {
      "kode": "1",
      "tekst": "Fjernvarme/blokvarme"
    },
    {
      "kode": "2",
      "tekst": "Centralvarme med én fyringsenhed"
    },
    {
      "kode": "3",
      "tekst": "Ovn til fast og flydende brændsel"
    },
    {
      "kode": "5",
      "tekst": "Varmepumpe"
    },
    {
      "kode": "6",
      "tekst": "Centralvarme med to fyringsenheder"
    },
    {
      "kode": "7",
      "tekst": "Elvarme"
    },
    {
      "kode": "8",
      "tekst": "Gasradiator"
    },
    {
      "kode": "9",
      "tekst": "Ingen varmeinstallation"
    },
    {
      "kode": "99",
      "tekst": "Varmeinstallation er registreret på enheder"
    }
  ]
}

Parametre

navnstringstipåkrævet
Kodelistens navn, fx varmeinstallation eller ydervaeg.Værdier:bygningsanvendelseenhedsanvendelsevarmeinstallationopvarmningsmiddelsupplerendevarmeydervaegtagdaekningbranchekodeEksempel: varmeinstallation

Felter i svaret

navnstring
Kodelistens navn, som du bad om den.
koder[]{ kode, tekst }[]
Alle koder i listen. kode er en streng, tekst den danske betegnelse.

Statuskoder

StatusBetydning
200Svaret er leveret.
404Der findes ingen kodeliste med det navn.
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/kodeliste/varmeinstallation

Bruges ofte sammen med