# Overvåg ejendomme

`POST /v1/overvaagning/ejendomme` · Overvågning

Sæt op til 100 ejendomme på overvågningslisten, så du får en webhook, når BBR, vurdering, plandata eller jord ændrer sig.

Hver ejendom læses cirka én gang i døgnet fra BBR, ejendomsvurdering, plandata og områdeklassificering. Ændrer ét af registrene sig, sendes `ejendom.aendret` til de endpoints, der abonnerer på den — se [Ejendomsovervågning](https://grundfast.dk/docs/ejendomsovervaagning).

Det første tjek er et udgangspunkt og sender ingen hændelse. BFE-numre, der allerede er på listen, røres ikke og returneres i `allerede_overvaaget`, så kaldet kan gentages uden skade.

**Godkendelse:** API-nøgle eller dashboard-session · kræver Pro-planen

**Afregning:** Ikke målt — overvågning følger med planen.

## Parametre

| Navn | Placering | Type | Påkrævet | Beskrivelse |
| --- | --- | --- | --- | --- |
| `bfe` | body | integer[] | ja | 1-100 BFE-numre. Dubletter i listen tælles én gang. |
| `note` | body | string | nej | Højst 200 tegn. Følger med på hver `ejendom.aendret` for de ejendomme, der tilføjes nu. |

## Request-body

```json
{
  "bfe": [5651067, 2425322],
  "note": "Portefølje Nord"
}
```

## Eksempel

```bash
curl -X POST "https://api.grundfast.dk/v1/overvaagning/ejendomme" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bfe":[5651067,2425322],"note":"Portefølje Nord"}'
```

## Svar (201)

```json
{
  "tilfoejet": 2,
  "allerede_overvaaget": [],
  "antal": 2,
  "maks": 250
}
```

## Vigtige felter

| Felt | Type | Betydning |
| --- | --- | --- |
| `tilfoejet` | integer | Hvor mange ejendomme der kom på listen med dette kald. |
| `allerede_overvaaget` | integer[] | De BFE-numre, der allerede var på listen, og som blev ladt urørt. |
| `maks` | integer | Planens loft for listen: 250 på Pro, 2.500 på Scale, 25.000 på Enterprise. |

## Fejl

| Status | Betydning |
| --- | --- |
| 400 | Kroppen er ugyldig: ingen BFE-numre, flere end 100, eller et ugyldigt tal. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 402 | Planen er under Pro. |
| 403 | Nøglen er en admin-nøgle, eller kontoen er suspenderet. |
| 429 | Burst-grænsen pr. minut er nået. |
| 409 | Listen ville komme over planens loft. Intet blev tilføjet. |