Overvåg ejendomme

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

POSThttps://api.grundfast.dk/v1/overvaagning/ejendomme

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.

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 session

Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.

Kræver Pro-planen

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

Afregning

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

Eksempel

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 · eksempel201json

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

Request-body

JSON med Content-Type: application/json.

bfeinteger[]bodypåkrævet: 1-100 BFE-numre. Dubletter i listen tælles én gang.
notestringbodyvalgfri: Højst 200 tegn. Følger med på hver ejendom.aendret for de ejendomme, der tilføjes nu.

Felter i svaret

tilfoejetinteger: Hvor mange ejendomme der kom på listen med dette kald.
allerede_overvaagetinteger[]: De BFE-numre, der allerede var på listen, og som blev ladt urørt.
maksinteger: Planens loft for listen: 250 på Pro, 2.500 på Scale, 25.000 på Enterprise.

Statuskoder

Status	Betydning
201	Oprettet — svaret beskriver det nye objekt.
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.

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

Bruges ofte sammen med

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 · eksempel201json

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