Spring til indhold

Grundfast

Slå op i batch

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

POST/v1/bbr/ejendom:batch

Send en liste af BFE-numre, og få hver ejendom tilbage i samme form som fra Hent en 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 · API-nøgle

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

Kræver Pro-planen

På en lavere plan svarer endpointet 402. Se planerne.

Afregning

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

Eksempel

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 · eksempel, forkortet200
{
  "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
}

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

Request-body

JSON med Content-Type: application/json.

bfeinteger[]bodypåkrævet
1-50 BFE-numre. Grænsen gælder listen, som den sendes — dubletter tæller med, indtil de fjernes.

Felter i svaret

results[]object[]
{ bfe, ejendom, stale } for hvert nummer, der kunne slås op. ejendom har samme form som et enkeltopslag.
results[].staleboolean
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.
failedinteger
Antal fejlede numre. requested = succeeded + failed.

Statuskoder

StatusBetydning
200Svaret er leveret.
400Kroppen er ikke { bfe: number[] } med 1-50 positive heltal.
401Nøglen mangler eller er ugyldig.
402Planen er under Pro.
429Burst-grænsen eller månedskvoten er nået; hele batchens antal enheder tæller mod kvoten. 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

Kræver din nøgle

Nøglen bliver i denne fane og sendes kun til grundfast.dk. Kaldet tæller som et almindeligt kald — brug en gf_test_-nøgle for at prøve gratis. Opret en gratis nøgle

POST /v1/bbr/ejendom:batch

Bruges ofte sammen med

Læs mere om BBR, og hvad data kan bruges til, på produktsiden.