Hent en kodeliste

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

GEThttps://api.grundfast.dk/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 · eksempel200json

{
  "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

Status	Betydning
200	Svaret er leveret.
404	Der findes ingen kodeliste med det navn.
429	Mere 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

Bruges ofte sammen med

curl "https://api.grundfast.dk/v1/kodeliste/varmeinstallation"

Svar · eksempel200json

{
  "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"
    }
  ]
}