# Slå op i batch

`POST /v1/bbr/ejendom:batch` · BBR

Op til 50 ejendomme i ét kald, med et resultat eller en fejl for hvert BFE-nummer.

Send en liste af BFE-numre, og få hver ejendom tilbage i samme form som fra [Hent en ejendom](https://grundfast.dk/docs/api/bbr-ejendom). Dubletter fjernes, før opslagene går i gang, og `requested` er antallet af unikke numre.

Svaret er `200`, også når nogle af numrene fejler: de fejlede står i `errors` med deres egen status (fx `404` for et ukendt BFE), og resten står i `results`. Kun en ugyldig krop giver `400`. Tjek derfor `failed` frem for statuskoden.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Pro-planen

**Afregning:** Kvoten tæller ét kald pr. unikt BFE-nummer; der faktureres kun for de numre, der blev slået op.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | body | integer[] | ja | 1-50 BFE-numre. Grænsen gælder listen, som den sendes — dubletter tæller med, indtil de fjernes. |

## Request-body

```json
{
  "bfe": [5651067, 2425322]
}
```

## Eksempel

```bash
curl -X POST "https://api.grundfast.dk/v1/bbr/ejendom:batch" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bfe":[5651067,2425322]}'
```

## Svar (200)

```json
{
  "results": [
    {
      "bfe": 5651067,
      "ejendom": {
        "type": "ejendom",
        "bfe_nummer": 5651067,
        "grund_id": "000000b1-6158-40f2-971a-86885749e705",
        "kommunekode": "0740",
        "dagi": {
          "kommune": {
            "kode": "0740",
            "navn": "Silkeborg"
          },
          "region": {
            "kode": "1082",
            "navn": "Region Midtjylland"
          }
        },
        "jordstykke": {
          "matrikelnummer": "138o",
          "ejerlav_kode": 2006552,
          "ejerlav_navn": "Silkeborg Markjorder"
        },
        "jordstykker": [
          {
            "matrikelnummer": "138o",
            "ejerlav_kode": 2006552,
            "ejerlav_navn": "Silkeborg Markjorder"
          }
        ],
        "antal_bygninger": 3,
        "hovedbygning_index": 2,
        "bygninger": [
          {
            "id": "738cd665-f22f-4fe6-b446-e7a04386c000",
            "type": "bygning",
            "bygningsnummer": 1,
            "anvendelse": {
              "kode": "120",
              "tekst": "Fritliggende enfamiliehus"
            },
            "opfoerelsesaar": null,
            "om_tilbygningsaar": null,
            "antal_etager": null,
            "afvigende_etager": null,
            "areal": {
              "bebygget_m2": null,
              "samlet_bygningsareal_m2": null,
              "samlet_boligareal_m2": null,
              "samlet_erhvervsareal_m2": null
            },
            "materialer": {
              "ydervaeg": null,
              "ydervaeg_supplerende": null,
              "tag": null,
              "tag_supplerende": null
            },
            "varme": {
              "installation": null,
              "opvarmningsmiddel": null,
              "supplerende": null
            },
            "asbest": null,
            "afloeb": {
              "afloebsforhold": null,
              "medlemskab_spildevandsforsyning": null,
              "paabud": null,
              "paabud_frist": null,
              "tilladelse_udtraeden": null,
              "tilladelse_udtraeden_dato": null,
              "tilladelse_alternativ_afledning": null,
              "tilladelse_alternativ_afledning_dato": null
            },
            "geometri": null,
            "kommunekode": "0740",
            "etager": {
              "registreringer": [],
              "kaelder_m2": null,
              "kaelder_lavloftet_m2": null,
              "udnyttet_tagetage_m2": null,
              "beboelse_i_kaelder_m2": null
            },
            "fredning": null,
            "enheder": []
          },
          {
            "id": "901088f3-b4e8-4acf-98f7-c69389c3e56f",
            "type": "bygning",
            "bygningsnummer": 2,
            "anvendelse": {
              "kode": "920",
              "tekst": "Carport"
            },
            "opfoerelsesaar": 2014,
            "om_tilbygningsaar": null,
            "antal_etager": null,
            "afvigende_etager": null,
            "areal": {
              "bebygget_m2": 25,
              "samlet_bygningsareal_m2": null,
              "samlet_boligareal_m2": null,
              "samlet_erhvervsareal_m2": null
            },
            "materialer": {
              "ydervaeg": {
                "kode": "5",
                "tekst": "Træ"
              },
              "ydervaeg_supplerende": null,
              "tag": {
                "kode": "2",
                "tekst": "Tagpap med stor hældning"
              },
              "tag_supplerende": null
            },
            "varme": {
              "installation": null,
              "opvarmningsmiddel": null,
              "supplerende": null
            },
            "asbest": null,
            "afloeb": {
              "afloebsforhold": null,
              "medlemskab_spildevandsforsyning": null,
              "paabud": null,
              "paabud_frist": null,
              "tilladelse_udtraeden": null,
              "tilladelse_udtraeden_dato": null,
              "tilladelse_alternativ_afledning": null,
              "tilladelse_alternativ_afledning_dato": null
            },
            "geometri": {
              "type": "Point",
              "coordinates": [
                9.5329415,
                56.157787
              ],
              "epsg25832": [
                533102.67,
                6223768.95
              ]
            },
            "kommunekode": "0740",
            "etager": {
              "registreringer": [],
              "kaelder_m2": null,
              "kaelder_lavloftet_m2": null,
              "udnyttet_tagetage_m2": null,
              "beboelse_i_kaelder_m2": null
            },
            "fredning": {
              "fredet": false,
              "status": 5,
              "status_tekst": "ingen_registrering",
              "bevaringsvaerdi": null,
              "kilde": "fbb",
              "hentet": "2026-09-02T13:48:56.275Z"
            },
            "enheder": []
          },
          {
            "id": "c7e65d4a-0c66-4838-9b19-728abbeddd71",
            "type": "bygning",
            "bygningsnummer": 1,
            "anvendelse": {
              "kode": "120",
              "tekst": "Fritliggende enfamiliehus"
            },
            "opfoerelsesaar": 1958,
            "om_tilbygningsaar": null,
            "antal_etager": 1,
            "afvigende_etager": null,
            "areal": {
              "bebygget_m2": 116,
              "samlet_bygningsareal_m2": 116,
              "samlet_boligareal_m2": 95,
              "samlet_erhvervsareal_m2": null
            },
            "materialer": {
              "ydervaeg": {
                "kode": "1",
                "tekst": "Mursten"
              },
              "ydervaeg_supplerende": null,
              "tag": {
                "kode": "5",
                "tekst": "Tegl"
              },
              "tag_supplerende": null
            },
            "varme": {
              "installation": {
                "kode": "1",
                "tekst": "Fjernvarme/blokvarme"
              },
              "opvarmningsmiddel": null,
              "supplerende": null
            },
            "asbest": null,
            "afloeb": {
              "afloebsforhold": null,
              "medlemskab_spildevandsforsyning": null,
              "paabud": null,
              "paabud_frist": null,
              "tilladelse_udtraeden": null,
              "tilladelse_udtraeden_dato": null,
              "tilladelse_alternativ_afledning": null,
              "tilladelse_alternativ_afledning_dato": null
            },
            "geometri": {
              "type": "Point",
              "coordinates": [
                9.532961,
                56.1578452
              ],
              "epsg25832": [
                533103.83,
                6223775.44
              ]
            },
            "kommunekode": "0740",
            "etager": {
              "registreringer": [
                {
                  "id": "c58382d9-fc6c-4aed-9019-8ece8e75beaf",
                  "betegnelse": "st",
                  "type": {
                    "kode": "0",
                    "tekst": "Regulær etage"
                  },
                  "areal_m2": null,
                  "udnyttet_tagetage_m2": null,
                  "kaelder_lavloftet_m2": null,
                  "beboelse_i_kaelder_m2": null
                },
                {
                  "id": "dc3964c2-775b-43de-b1c7-55970a18dca3",
                  "betegnelse": "kl",
                  "type": {
                    "kode": "2",
                    "tekst": "Kælder"
                  },
                  "areal_m2": 45,
                  "udnyttet_tagetage_m2": null,
                  "kaelder_lavloftet_m2": null,
                  "beboelse_i_kaelder_m2": null
                }
              ],
              "kaelder_m2": 45,
              "kaelder_lavloftet_m2": null,
              "udnyttet_tagetage_m2": null,
              "beboelse_i_kaelder_m2": null
            },
            "fredning": {
              "fredet": false,
              "status": 5,
              "status_tekst": "ingen_registrering",
              "bevaringsvaerdi": null,
              "kilde": "fbb",
              "hentet": "2026-09-02T13:48:56.275Z"
            },
            "enheder": [
              {
                "id": "b2664519-d2d0-4238-a1cd-4bafa67dcb67",
                "anvendelse": {
                  "kode": "120",
                  "tekst": "Fritliggende enfamiliehus"
                },
                "areal": {
                  "samlet_m2": 95
                },
                "antal_vaerelser": 4,
                "varme": {
                  "installation": null,
                  "opvarmningsmiddel": null
                },
                "etage": {
                  "betegnelse": "st",
                  "type": {
                    "kode": "0",
                    "tekst": "Regulær etage"
                  }
                },
                "adresse": {
                  "id": "0a3f50c2-09e9-32b8-e044-0003ba298018",
                  "doer": "",
                  "etage": "",
                  "husnr": "70",
                  "postnr": "8600",
                  "vejnavn": "Solbakkevej",
                  "koordinat": {
                    "lat": 56.1578452,
                    "lon": 9.532961
                  },
                  "betegnelse": "Solbakkevej 70, 8600 Silkeborg",
                  "postnrnavn": "Silkeborg",
                  "kommunekode": null
                }
              }
            ]
          }
        ],
        "meta": {
          "kilde": "Datafordeler BBR via Grundfast",
          "grundfast_version": "0.1.0"
        },
        "vurdering": {
          "seneste": {
            "aar": 2024,
            "grundvaerdi_kr": 1702000,
            "ejendomsvaerdi_kr": 2596000,
            "vurderet_areal_m2": 460
          },
          "historik": [
            {
              "aar": 2024,
              "grundvaerdi_kr": 1702000,
              "ejendomsvaerdi_kr": 2596000
            },
            {
              "aar": 2022,
              "grundvaerdi_kr": 1661000,
              "ejendomsvaerdi_kr": 2553000
            },
            {
              "aar": 2020,
              "grundvaerdi_kr": 1330000,
              "ejendomsvaerdi_kr": 2229000
            },
            {
              "aar": 2019,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2018,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2017,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2016,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2015,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2014,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2013,
              "grundvaerdi_kr": 645000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2012,
              "grundvaerdi_kr": 661500,
              "ejendomsvaerdi_kr": 1800000
            },
            {
              "aar": 2011,
              "grundvaerdi_kr": 661500,
              "ejendomsvaerdi_kr": 1800000
            },
            {
              "aar": 2010,
              "grundvaerdi_kr": 598500,
              "ejendomsvaerdi_kr": 1800000
            },
            {
              "aar": 2009,
              "grundvaerdi_kr": 598500,
              "ejendomsvaerdi_kr": 1800000
            },
            {
              "aar": 2008,
              "grundvaerdi_kr": 630000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2007,
              "grundvaerdi_kr": 630000,
              "ejendomsvaerdi_kr": 1750000
            },
            {
              "aar": 2006,
              "grundvaerdi_kr": 436600,
              "ejendomsvaerdi_kr": 1400000
            },
            {
              "aar": 2005,
              "grundvaerdi_kr": 415800,
              "ejendomsvaerdi_kr": 1350000
            },
            {
              "aar": 2004,
              "grundvaerdi_kr": 315000,
              "ejendomsvaerdi_kr": 1200000
            },
            {
              "aar": 2003,
              "grundvaerdi_kr": 315000,
              "ejendomsvaerdi_kr": 1200000
            },
            {
              "aar": 2002,
              "grundvaerdi_kr": 289800,
              "ejendomsvaerdi_kr": 1100000
            },
            {
              "aar": 2001,
              "grundvaerdi_kr": 264600,
              "ejendomsvaerdi_kr": 1050000
            }
          ],
          "antal_vurderingsejendomme": 1
        }
      },
      "stale": false
    }
  ],
  "errors": [],
  "requested": 2,
  "succeeded": 2,
  "failed": 0
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `results[]` | object[] | `{ bfe, ejendom, stale }` for hvert nummer, der kunne slås op. `ejendom` har samme form som et enkeltopslag. |
| `results[].stale` | boolean | `true` når ejendommen blev serveret fra cache, fordi Datafordeler var nede. Svaret bærer så også headeren `X-Grundfast-Stale: true`. |
| `errors[]` | object[] | `{ bfe, error, status }` for hvert nummer, der fejlede — fx `404` for et ukendt BFE eller `502` ved en upstream-fejl. |
| `failed` | integer | Antal fejlede numre. `requested` = `succeeded` + `failed`. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Kroppen er ikke `{ bfe: number[] }` med 1-50 positive heltal. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Planen er under Pro. |
| 429 | Burst-grænsen eller månedskvoten er nået; hele batchens antal enheder tæller mod kvoten. Se `Retry-After`. |