# Hent energimærket

`GET /v1/energimaerke/:bfe` · Energimærke

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

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.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`)

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

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | path | integer | ja | BFE-nummeret på den ejendom, hvis energimærke du vil have. |

## Eksempel

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

## Svar (200)

```json
{
  "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"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `label.klasse` | string \| null | Energiklassen, fra `A2020` til `G`. |
| `label.gyldig_til` | string \| 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[].aar` | null | 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. |
| `bygning` | object | Bygningens BBR-oplysninger, som de står på mærket: opførelsesår, om-/tilbygningsår, anvendelseskode og bolig- og erhvervsareal. |

## Fejl

| Status | Betydning |
| --- | --- |
| 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ø. |

> 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.