# Søg i bygninger

`GET /v1/bbr/bygninger/soeg` · BBR

Alle stående bygninger i hele landet, en kommune, et postnummer eller et kortudsnit — filtreret på BBR-fakta og på grundareal, jordforurening, fredning og energimærke.

Bygningssøgningen svarer på spørgsmål om bygningsbestanden frem for om én ejendom: hvilke huse fra før 1960 i en kommune opvarmes stadig med olie, hvor står der tage af fibercement, hvilke bygninger har en olietank i brug på grunden. Svaret kommer fra et nationalt bygningsindeks over BBR, med adresse, BFE-nummer og WGS84-punkt på hver bygning, så resultatet kan gå direkte videre til [Hent en ejendom](https://grundfast.dk/docs/api/bbr-ejendom).

Området er højst ét af `kommunekode`, `postnr` og `bbox` (et kortudsnit på højst 1° hver vej). Uden område søger du i hele landet. Alle filtre kombineres med OG; et filter med flere koder (fx `varme=2,7`) matcher enhver af dem. `anvendelse` tager både BBR-koder og grupper (`bolig`, `enfamiliehus`, `raekkehus`, `etagebolig`, `landbrug`, `industri`, `energi`, `handel_kontor`, `institution`, `sommerhus`, `fritid`, `udhus_garage`).

Ud over BBR’s egne felter (inkl. etager, afløb, spildevandspåbud, solceller og jordvarme) kan du filtrere på fakta fra andre registre, som indekset har koblet på bygningen: ejendommens grundareal fra Matriklen, kortlagt jordforurening (V1/V2) fra Danmarks Miljøportal, fredning og SAVE-værdi fra Slots- og Kulturstyrelsen og energimærkets klasse fra Grundfasts energimærke-korpus.

`antal` er altid det præcise antal bygninger, der matcher. Alle planer får antallet og første side (op til 100 bygninger som JSON). Flere sider og `format=csv`, `jsonl` eller `geojson` kræver Starter eller højere; uden den svarer de med `402`. Søgninger i en kommune eller et postnummer sorteres efter adresse, kortudsnit og hele landet efter bygnings-id.

Med `group_by` svarer søgningen med en fordeling i stedet for en side bygninger: det præcise antal pr. gruppe for samme filter, i ét kald. `aarti` grupperer på opførelsesårti (`1960` = 1960–1969), `tag` på tagdækningsmateriale, `anvendelse` på BBR-anvendelse, `kommune` på kommunekode, `varme` på varmeinstallation og `energimaerke` på energimærkets klasse. Svaret har `type: "bygningsgruppering"`, `antal` (summen) og `grupper` med `noegle`, `tekst`, `antal` og `andel`. Det er åbent for alle planer og kun JSON. Det virker for ethvert område, også hele landet.

**Godkendelse:** `Authorization: Bearer gf_live_…` (eller `gf_test_…`) · kræver Starter-planen til side 2 og frem samt CSV/GeoJSON

**Afregning:** Ét kald pr. påbegyndte 1.000 rækker i `per_side` (standard 100 = ét kald). Med `group_by` altid ét kald.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `kommunekode` | query | string | nej | Kommunekoden, fx `0740`. Højst ét af `kommunekode`, `postnr` og `bbox`. |
| `postnr` | query | string | nej | Postnummeret, fx `8600`. |
| `bbox` | query | string | nej | Kortudsnit `minLon,minLat,maxLon,maxLat` i WGS84, højst 1° hver vej, fx `12.50,55.65,12.62,55.71`. |
| `anvendelse` | query | string | nej | Kommasepareret liste af BBR-anvendelseskoder og/eller grupper. |
| `opfoert_fra` | query | integer | nej | Opført i dette år eller senere. |
| `opfoert_til` | query | integer | nej | Opført i dette år eller tidligere. |
| `varme` | query | string | nej | Koder for varmeinstallation (BBR felt 056), fx `2,7`. |
| `opvarmning` | query | string | nej | Koder for opvarmningsmiddel (felt 057), fx `3` for flydende brændsel. |
| `tag` | query | string | nej | Koder for tagdækning (felt 033), fx `3` for fibercement herunder asbest. |
| `ydervaeg` | query | string | nej | Koder for ydervæggens materiale (felt 032). |
| `asbest` | query | string | nej | `ja`: BBR registrerer asbestholdigt materiale (felt 036, kode 1-4). `nej`: registreret uden asbest (kode 5). |
| `areal_min` | query | integer | nej | Mindste samlede bygningsareal i m². |
| `areal_max` | query | integer | nej | Største samlede bygningsareal i m². |
| `boligareal_min` | query | integer | nej | Mindste boligareal i m². |
| `boligareal_max` | query | integer | nej | Største boligareal i m². |
| `olietank` | query | string | nej | `ja`: der er registreret en olietank i brug (ikke sløjfet) på grunden. `nej`: der er ikke. |
| `etager_min · etager_max` | query | integer | nej | Antal etager (BBR felt 054). |
| `grundareal_min · grundareal_max` | query | integer | nej | Ejendommens registrerede areal i Matriklen (alle dens jordstykker) i m². |
| `energimaerke` | query | string | nej | Energimærkets klasse, kommasepareret, fx `F,G`. Finder kun mærker, der er i Grundfasts korpus — dækningen er delvis. |
| `afloeb` | query | string | nej | Koder for afløbsforhold (felt 031, ellers grundens felt 010). |
| `spildevandspaabud` | query | string | nej | `ja`: BBR registrerer et påbud om forbedret rensning eller tilslutning (rensningspåbud 2-7). `nej`: “Rensning ok. Intet påbud”. |
| `solceller · jordvarme` | query | string | nej | `ja`/`nej`: et solcelleanlæg (teknisk anlæg 1230) eller jordvarmeslanger (1220) i brug på grunden eller bygningen. |
| `jordforurening` | query | string | nej | `v1`, `v2`, `kortlagt` (enten) eller `nej`: kortlægning på en af ejendommens matrikler. |
| `fredet` | query | string | nej | `ja`/`nej`: bygningen er fredet. |
| `bevaringsvaerdi_max` | query | integer | nej | SAVE-værdi højst dette tal (1 er højest), fx `4`. |
| `side` | query | integer | nej | Sidenummer. Side 2 og frem kræver Starter eller højere. |
| `per_side` | query | integer | nej | Bygninger pr. side: højst 1.000 som JSON og 10.000 som CSV, JSON Lines eller GeoJSON. |
| `format` | query | string | nej | `json`, `jsonl` (én bygning pr. linje), `csv` eller `geojson` (FeatureCollection af punkter). |
| `group_by` | query | string | nej | Svar med antal pr. gruppe i stedet for bygninger: `aarti` (opførelsesårti), `tag` (tagdækning), `anvendelse`, `kommune`, `varme` (varmeinstallation) eller `energimaerke` (energimærkets klasse). Kun JSON; `side` og `per_side` ignoreres. Svaret er da `{ type: "bygningsgruppering", group_by, antal, grupper: [{ noegle, tekst, antal, andel }] }`. |

## Eksempel

```bash
curl -G "https://api.grundfast.dk/v1/bbr/bygninger/soeg" \
  --data-urlencode "kommunekode=0740" \
  --data-urlencode "anvendelse=institution" \
  --data-urlencode "tag=3" \
  --data-urlencode "per_side=1" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"
```

## Svar (200)

```json
{
  "type": "bygningssoegning",
  "antal": 180,
  "side": 1,
  "per_side": 1,
  "sider": 180,
  "begraenset": false,
  "bygninger": [
    {
      "id": "69eaf49f-6930-47e9-8b65-d1b91ce38d5a",
      "bfe_nummer": 4040359,
      "adgangsadresse_id": "0a3f5095-4239-32b8-e044-0003ba298018",
      "adresse": "A.Andersens Vej 24B, 8600 Silkeborg",
      "kommunekode": "0740",
      "postnr": "8600",
      "koordinat": { "lon": 9.585017, "lat": 56.191006 },
      "anvendelse": { "kode": "429", "tekst": "Anden bygning til undervisning og forskning" },
      "opfoerelsesaar": 1968,
      "om_tilbygningsaar": null,
      "samlet_areal": 180,
      "boligareal": 179,
      "erhvervsareal": 180,
      "antal_etager": 1,
      "varmeinstallation": { "kode": "1", "tekst": "Fjernvarme/blokvarme" },
      "opvarmningsmiddel": null,
      "supplerende_varme": { "kode": "1", "tekst": "Varmepumpe" },
      "tagdaekning": { "kode": "3", "tekst": "Fibercement herunder asbest" },
      "ydervaeg": { "kode": "1", "tekst": "Mursten" },
      "asbest": null,
      "olietank": false
    }
  ],
  "meta": {
    "kilde": "BBR + DAR (Datafordeler) via Grundfast — bygningsindeks",
    "grundfast_version": "0.1.0"
  }
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `antal` | integer | Det præcise antal bygninger, der matcher. |
| `grupper[]` | { noegle, tekst, antal, andel }[] | Kun med `group_by`. `noegle` er årtiets første år (`"1960"`), BBR-koden (`"3"`), kommunekoden (`"0751"`) eller energimærkets klasse (`"C"`); `null` er bygninger uden registreret værdi — for `energimaerke` bygninger uden et mærke i vores data. For `aarti` tæller BBR’s pladsholderår 1000 også som ukendt. `andel` er gruppens andel af `antal` (0–1). `aarti` står i årti-rækkefølge med ukendt sidst, de øvrige efter antal. |
| `begraenset` | boolean | `true`, når planen begrænsede svaret til første side. `antal` er stadig præcist. |
| `bygninger[].olietank` | boolean | Der er registreret en olietank i brug på bygningens grund eller på bygningen selv. Siger intet om, hvad bygningen opvarmes med. |
| `bygninger[].asbest` | { kode, tekst } \| null | BBR-feltet om asbestholdigt materiale. `null` betyder, at feltet ikke er udfyldt, ikke at bygningen er fri for asbest. |
| `bygninger[].jordforurening` | 'V1' \| 'V2' \| 'V1 og V2' \| null | Kortlægning på en af ejendommens matrikler. `null`: ikke kortlagt. |
| `bygninger[].energimaerke` | 'A' … 'G' \| null | Klassen, når ejendommens mærke er i Grundfasts korpus. `null` betyder ikke, at ejendommen er uden mærke. |
| `omfang` | 'kommune' \| 'postnummer' \| 'kortudsnit' \| 'hele_landet' | Det område, søgningen dækkede. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Mere end ét område, et kortudsnit over 1° eller uden for Danmark, `group_by` kombineret med `format=csv`/`jsonl`/`geojson`, eller et ugyldigt filter. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Side 2 og frem eller CSV/JSON Lines/GeoJSON kræver Starter eller højere. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se `Retry-After`. |
| 503 | Bygningsindekset (eller den udvidede version, et filter kræver) er ikke indlæst, eller landsdækkende søgning har travlt. Se `Retry-After`. |

> Et tomt BBR-felt er ukendt, ikke nej: en bygning uden registreret asbest eller varmeinstallation matcher ikke et filter på feltet.

> Energimærker kommer fra Grundfasts korpus, som vokser ejendom for ejendom. Et filter på klassen finder kun de mærker, korpusset har — ikke alle mærker i Danmark.
