suchprofil_aktivboolean
limitinteger
Default:25
>= 1<= 100
cursorstring
Interessenten
Interessenten auflisten
get
Query Parameters
Response
application/json
Response
application/json
Trefferliste
datenarray
Show Child Parameters
seiteobject
Cursor-basierte Paginierung.
Show Child Parameters
get/interessenten
Authentication
Query Parameters
application/json
Interessent anlegen
post
Body
application/json
Body
application/json
InteressentAnlegen
vornamestring
Example:Anna
nachnamestringrequired
Example:Bergmann
emailstring(email)required
Example:a.bergmann@example.org
telefonstring
Example:+49 40 1234567
einwilligungobjectrequired
Nachweis der datenschutzrechtlichen Einwilligung.
Show Child Parameters
suchprofilobject
Show Child Parameters
Response
application/json
Response
application/json
Angelegt
Interessent
vornamestring
Example:Anna
nachnamestringrequired
Example:Bergmann
emailstring(email)required
Example:a.bergmann@example.org
telefonstring
Example:+49 40 1234567
einwilligungobjectrequired
Nachweis der datenschutzrechtlichen Einwilligung.
Show Child Parameters
suchprofilobject
Show Child Parameters
idstring
Example:int_71ab
aufbewahrung_bisstring(date)
Automatisch gesetzte Löschfrist. Danach wird anonymisiert.
Example:2027-02-18
angelegt_amstring(date-time)
Example:2026-08-18T10:22:04Z
post/interessenten
Authentication
Body
{
"vorname": "Anna",
"nachname": "Bergmann",
"email": "a.bergmann@example.org",
"telefon": "+49 40 1234567",
"einwilligung": {
"zweck": "objektvermittlung",
"erteilt_am": "2026-08-18T10:22:00Z"
},
"suchprofil": {
"typ": [
"wohnung"
],
"orte": [
"Hamburg"
],
"zimmer_min": 3,
"kaufpreis_max_eur": 700000
}
}
application/json
Interessent abrufen
get
Path Parameters
interessentIdstringrequired
Example:int_71ab
Response
application/json
Response
application/json
Interessent
Interessent
vornamestring
Example:Anna
nachnamestringrequired
Example:Bergmann
emailstring(email)required
Example:a.bergmann@example.org
telefonstring
Example:+49 40 1234567
einwilligungobjectrequired
Nachweis der datenschutzrechtlichen Einwilligung.
Show Child Parameters
suchprofilobject
Show Child Parameters
idstring
Example:int_71ab
aufbewahrung_bisstring(date)
Automatisch gesetzte Löschfrist. Danach wird anonymisiert.
Example:2027-02-18
angelegt_amstring(date-time)
Example:2026-08-18T10:22:04Z
get/interessenten/{interessentId}
Authentication
Path Parameters
application/json
Löschung veranlassen
Setzt ein Betroffenenrecht sofort um. Personenbezogene Felder werden
unwiderruflich entfernt; steuerlich aufbewahrungspflichtige Vorgänge
bleiben pseudonymisiert erhalten.
post
Path Parameters
interessentIdstringrequired
Example:int_71ab
Body
application/json
Body
application/json
grundstringrequired
Allowed values:betroffenenrechtfrist_abgelaufendoublette
quellestring
Example:e-mail vom 2026-08-18
Response
202 application/json
Response
202 application/json
Löschung eingeleitet
interessent_idstring
anonymisiert_amstring(date-time)
post/interessenten/{interessentId}/loeschung
Authentication
Path Parameters
Body
{
"grund": "betroffenenrecht"
}
202 application/json