# Hent ejendomsvurderinger

`GET /v1/vurdering/:bfe` · Ejendomsvurdering

Alle ejendomsvurderinger, Vurderingsstyrelsen har for et BFE-nummer: ejendomsværdi, grundværdi, areal, dækningsafgift og kategori for hvert år.

Svaret er grupperet pr. vurderingsejendom, og hver gruppe har hele sin serie, nyeste først, plus den seneste vurdering i `seneste`. Beløb er i **hele kroner**, ikke øre.

En vurderingsejendom er ikke det samme som et BFE. Et BFE kan dække flere vurderingsejendomme, endda i forskellige kommuner, og så findes der ikke ét ærligt tal for ejendommen. Læs derfor `antal_vurderingsejendomme` først: er den større end 1, er `seneste` på topniveau `null`, og du skal læse serierne i `vurderingsejendomme`.

Ét år kan have flere rækker med forskellig `vurderingsmarkering` og forskellige beløb. De rapporteres alle, som Vurderingsstyrelsen har dem; `seneste` vælger rækken med det højeste år og, ved lighed, den senest ajourførte.

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

**Afregning:** Ét kald.

## Parametre

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

## Eksempel

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

## Svar (200)

```json
{
  "bfe_nummer": 2425322,
  "seneste": {
    "aar": 2020,
    "vurderingsmarkering": 3,
    "ejendomsvaerdi_kr": 796000,
    "grundvaerdi_kr": 216000,
    "vurderet_areal_m2": 2291,
    "aendringsdato": "2020-01-01",
    "aendringskode": null,
    "benyttelseskode": "08",
    "juridisk_kategori": {
      "kode": 1100,
      "tekst": "Ejerbolig  til vurdering i lige år"
    },
    "juridisk_underkategori": {
      "kode": 1130,
      "tekst": "Sommerhus eller andet fritidshus"
    },
    "daekningsafgift": null,
    "antal_medvurderede_lejligheder": 1,
    "vurderingskreds_kode": 0,
    "ajourfoert": "2024-07-02T01:26:02.000000Z"
  },
  "antal_vurderingsejendomme": 1,
  "vurderingsejendomme": [
    {
      "vurderingsejendom_id": 413005860001914,
      "esr_kommunenummer": 306,
      "esr_ejendomsnummer": 22830,
      "seneste": {
        "aar": 2020,
        "vurderingsmarkering": 3,
        "ejendomsvaerdi_kr": 796000,
        "grundvaerdi_kr": 216000,
        "vurderet_areal_m2": 2291,
        "aendringsdato": "2020-01-01",
        "aendringskode": null,
        "benyttelseskode": "08",
        "juridisk_kategori": {
          "kode": 1100,
          "tekst": "Ejerbolig  til vurdering i lige år"
        },
        "juridisk_underkategori": {
          "kode": 1130,
          "tekst": "Sommerhus eller andet fritidshus"
        },
        "daekningsafgift": null,
        "antal_medvurderede_lejligheder": 1,
        "vurderingskreds_kode": 0,
        "ajourfoert": "2024-07-02T01:26:02.000000Z"
      },
      "vurderinger": [
        {
          "aar": 2020,
          "vurderingsmarkering": 3,
          "ejendomsvaerdi_kr": 796000,
          "grundvaerdi_kr": 216000,
          "vurderet_areal_m2": 2291,
          "aendringsdato": "2020-01-01",
          "aendringskode": null,
          "benyttelseskode": "08",
          "juridisk_kategori": {
            "kode": 1100,
            "tekst": "Ejerbolig  til vurdering i lige år"
          },
          "juridisk_underkategori": {
            "kode": 1130,
            "tekst": "Sommerhus eller andet fritidshus"
          },
          "daekningsafgift": null,
          "antal_medvurderede_lejligheder": 1,
          "vurderingskreds_kode": 0,
          "ajourfoert": "2024-07-02T01:26:02.000000Z"
        },
        {
          "aar": 2020,
          "vurderingsmarkering": 1,
          "ejendomsvaerdi_kr": 880000,
          "grundvaerdi_kr": 285900,
          "vurderet_areal_m2": 2291,
          "aendringsdato": "2020-10-01",
          "aendringskode": "H",
          "benyttelseskode": "08",
          "juridisk_kategori": null,
          "juridisk_underkategori": null,
          "daekningsafgift": null,
          "antal_medvurderede_lejligheder": 0,
          "vurderingskreds_kode": 3,
          "ajourfoert": "2021-02-13T12:38:18.000000Z"
        }
      ]
    }
  ],
  "meta": {
    "kilde": "Vurderingsstyrelsen (VUR) — offline eksempel",
    "hentet": "2026-09-01T00:00:00.000Z"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal_vurderingsejendomme` | integer | Antallet af vurderingsejendomme bag BFE-nummeret. Læs det før `seneste`: over 1 betyder, at der ikke findes én samlet værdi. |
| `seneste` | object \| null | Den nyeste vurdering — kun når der er præcis én vurderingsejendom. `null` betyder "spørg mere præcist", aldrig "ikke vurderet"; en ejendom uden vurdering er en `404`. |
| `vurderingsejendomme[].vurderinger[].ejendomsvaerdi_kr` | integer \| null | Ejendomsværdien i hele kroner. `grundvaerdi_kr` er grundværdien, også i hele kroner. |
| `vurderingsejendomme[].vurderinger[].vurderingsmarkering` | integer | Vurderingsstyrelsens markering af kilde og type. Ét år kan have flere rækker med forskellig markering og forskellige beløb. |
| `vurderingsejendomme[].vurderinger[].vurderet_areal_m2` | number \| null | Det vurderede grundareal i m², inklusive vejareal. |
| `vurderingsejendomme[].vurderinger[].daekningsafgift` | object \| null | Dækningsafgiften med forskelsværdi og pligtkoder, eller `null` når rækken ikke registrerer nogen. |
| `vurderingsejendomme[].vurderinger[].juridisk_kategori` | { kode, tekst } \| null | Vurderingsstyrelsens egen kategori, fx "Ejerbolig til vurdering i lige år". `null` på rækker uden kategori. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | BFE-nummeret er ikke et positivt heltal. |
| 401 | Nøglen mangler eller er ugyldig. |
| 404 | Vurderingsstyrelsen har ingen vurdering for BFE-nummeret — typisk en ejendom oprettet efter seneste vurderingsrunde. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 502 | Vurderingsstyrelsens tjeneste svarede ikke eller svarede ubrugeligt. En fejl bliver aldrig til en tom serie. |
| 503 | Kilden er ikke konfigureret i dette miljø. |