Spring til indhold

Grundfast

Slå op i batch

Mange ejendomme i ét kald — 50 på Pro, flere på Scale og Enterprise — 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
BFE-numre. Antallet pr. kald følger planen: 50 på Pro, 100 på Scale og 150 på Enterprise. En længere liste afvises med 402, der nævner den plan, der tager den — eller send listen som et job. Grænsen gælder listen, efter at dubletter er fjernet.

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 positive heltal, eller listen er længere, end nogen plan tager pr. kald.
401Nøglen mangler eller er ugyldig.
402Planen er under Pro, eller listen er længere end din plans loft pr. kald. Svaret nævner den plan, der tager den.
429Burst-grænsen eller månedskvoten er nået; hele batchens antal enheder tæller mod kvoten. Se Retry-After.

Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.

Fejlsvar · 404
{
  "error": "property not found",
  "type": "not_found",
  "code": "not_found",
  "message": "Ressourcen findes ikke.",
  "request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
  "doc_url": "https://grundfast.dk/docs/fejl#not_found"
}

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.