Hent energimærket

Det gældende energimærke for en ejendom: energiklasse, gyldighed, vinduer og forbedringsforslag — for de ejendomme, registret dækker.

GEThttps://api.grundfast.dk/v1/energimaerke/{bfe}

Svaret er energimærket, som det er udstedt: klasse (A2020 til G), udstedelses- og udløbsdato, bygningens BBR-oplysninger, som de står på mærket, vinduer og døre grupperet pr. type med U-værdi og areal, og energikonsulentens forbedringsforslag med anslået årlig besparelse.

Registret er ikke landsdækkende. Det svarer ud fra et datasæt, der er høstet ejendom for ejendom, og dækker kun de BFE-numre, der er slået op. Et BFE uden for datasættet giver 503, ikke 404: det betyder, at vi ikke ved det endnu, ikke at ejendommen er uden energimærke. Først en 404 siger, at en dækket ejendom ikke har noget mærke.

Registret er ikke landsdækkende. Behandl 503 som "ikke dækket endnu", ikke som "intet energimærke" — kun 404 betyder, at ejendommen ikke har et mærke.

Godkendelse · API-nøgle

Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.

Afregning

Ét kald. Et 503 for et BFE uden dækning tæller ikke mod kvoten.

Eksempel

curl "https://api.grundfast.dk/v1/energimaerke/6022368" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · fra demo-endpointet, forkortet200json

{
  "bfe_nummer": 6022368,
  "label": {
    "serial": "311699789",
    "klasse": "C",
    "gyldig_til": "2033-08-14",
    "udstedt": "2023-08-14",
    "bygning_bbr_uuid": null
  },
  "bygning": {
    "opfoert_aar": 1867,
    "renoveret_aar": 2013,
    "anvendelseskode": 140,
    "bolig_areal_m2": 1115,
    "erhverv_areal_m2": 506
  },
  "vinduer": [
    {
      "beskrivelse": "Flerfagsvindue med gående rammer - 3 lags energirude - energiklasse B",
      "lang_beskrivelse": "Vinduer i lejligheder og på trapper, samt altandøre er monteret med 3-lags energiglas.",
      "antal": 5,
      "aar": null,
      "u_vaerdi": 1.2,
      "rude_type": "3-lag",
      "areal_m2": 165
    },
    {
      "beskrivelse": "Kviste",
      "lang_beskrivelse": "Vinduer i lejligheder og på trapper, samt altandøre er monteret med 3-lags energiglas.",
      "antal": 4,
      "aar": null,
      "u_vaerdi": 1.2,
      "rude_type": null,
      "areal_m2": 12.7
    }
  ],
  "forbedringsforslag": [
    {
      "beskrivelse": "Vinduer med 2-lags termoglas udskiftes",
      "aarlig_besparelse_kr": 3400,
      "investering_kr": null
    },
    {
      "beskrivelse": "Belysning i restaurantskøkken i kælder udskiftes",
      "aarlig_besparelse_kr": 1700,
      "investering_kr": 10000
    }
  ],
  "meta": {
    "kilde": "Energistyrelsen (Energimærkeordningen) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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

Parametre

bfeintegerstipåkrævet: BFE-nummeret på den ejendom, hvis energimærke du vil have.Eksempel: 6022368

Felter i svaret

label.klassestring | null: Energiklassen, fra A2020 til G.
label.gyldig_tilstring | null: ISO-dato for mærkets udløb. Et energimærke gælder typisk i 10 år fra udstedt.
vinduer[]object[]: Vinduer og døre grupperet pr. type med beskrivelse, antal, u_vaerdi (W/m²K), areal_m2 og en normaliseret rude_type, fx termorude eller 3-lag. Kan være tom.
vinduer[].aarnull: Altid null: energimærket registrerer intet år pr. vindue. Brug bygning.renoveret_aar og bygning.opfoert_aar for alder.
forbedringsforslag[]object[]: Konsulentens forslag med aarlig_besparelse_kr og investering_kr i hele kroner, hver null når mærket ikke angiver beløbet. Kan være tom.
bygningobject: Bygningens BBR-oplysninger, som de står på mærket: opførelsesår, om-/tilbygningsår, anvendelseskode og bolig- og erhvervsareal.

Statuskoder

Status	Betydning
200	Svaret er leveret.
400	BFE-nummeret er ikke et positivt heltal.
401	Nøglen mangler eller er ugyldig.
404	Ejendommen er dækket af registret, men har intet energimærke.
429	Burst-grænsen eller månedskvoten er nået. Se `Retry-After`.
503	BFE-nummeret er endnu ikke dækket af registret — det siger intet om, hvorvidt ejendommen har et mærke. Gives også, hvis registret ikke er slået til i dette miljø.

Fejl har altid formen { "error": "…" }. Se Fejl og statuskoder for, hvad der kan prøves igen.

Prøv det

Live-kald fra siden

Bruges ofte sammen med

curl "https://api.grundfast.dk/v1/energimaerke/6022368" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Svar · demo, forkortet200json

{
  "bfe_nummer": 6022368,
  "label": {
    "serial": "311699789",
    "klasse": "C",
    "gyldig_til": "2033-08-14",
    "udstedt": "2023-08-14",
    "bygning_bbr_uuid": null
  },
  "bygning": {
    "opfoert_aar": 1867,
    "renoveret_aar": 2013,
    "anvendelseskode": 140,
    "bolig_areal_m2": 1115,
    "erhverv_areal_m2": 506
  },
  "vinduer": [
    {
      "beskrivelse": "Flerfagsvindue med gående rammer - 3 lags energirude - energiklasse B",
      "lang_beskrivelse": "Vinduer i lejligheder og på trapper, samt altandøre er monteret med 3-lags energiglas.",
      "antal": 5,
      "aar": null,
      "u_vaerdi": 1.2,
      "rude_type": "3-lag",
      "areal_m2": 165
    },
    {
      "beskrivelse": "Kviste",
      "lang_beskrivelse": "Vinduer i lejligheder og på trapper, samt altandøre er monteret med 3-lags energiglas.",
      "antal": 4,
      "aar": null,
      "u_vaerdi": 1.2,
      "rude_type": null,
      "areal_m2": 12.7
    }
  ],
  "forbedringsforslag": [
    {
      "beskrivelse": "Vinduer med 2-lags termoglas udskiftes",
      "aarlig_besparelse_kr": 3400,
      "investering_kr": null
    },
    {
      "beskrivelse": "Belysning i restaurantskøkken i kælder udskiftes",
      "aarlig_besparelse_kr": 1700,
      "investering_kr": 10000
    }
  ],
  "meta": {
    "kilde": "Energistyrelsen (Energimærkeordningen) via Grundfast",
    "grundfast_version": "0.1.0"
  }
}

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