Search
K
Objektverwaltung

Objekt anlegen

post

Body

application/json

ObjektAnlegen

typstringrequired

Allowed values:wohnunghausgrundstueckgewerbestellplatz

Example:wohnung

titelstringrequired

<= 120 characters

Example:3-Zimmer-Altbau am Falkenried

beschreibungstring

Example:Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.

adresseobjectrequired
Show Child Parameters
wohnflaeche_qmnumber(float)

Example:86.5

grundstuecksflaeche_qmnumber(float)

Example:412

zimmernumber(float)

Example:3

baujahrinteger

Example:1908

etageinteger

Example:2

kaufpreis_eurinteger

Example:645000

kaltmiete_eurinteger

Example:1450

nebenkosten_eurinteger

Example:280

verfuegbar_abstring(date)

Example:2026-11-01

energieausweisobject

Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.

Show Child Parameters
provisionobject
Show Child Parameters

Response

application/json

Angelegt

Objekt

typstringrequired

Allowed values:wohnunghausgrundstueckgewerbestellplatz

Example:wohnung

titelstringrequired

<= 120 characters

Example:3-Zimmer-Altbau am Falkenried

beschreibungstring

Example:Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.

adresseobjectrequired
Show Child Parameters
wohnflaeche_qmnumber(float)

Example:86.5

grundstuecksflaeche_qmnumber(float)

Example:412

zimmernumber(float)

Example:3

baujahrinteger

Example:1908

etageinteger

Example:2

kaufpreis_eurinteger

Example:645000

kaltmiete_eurinteger

Example:1450

nebenkosten_eurinteger

Example:280

verfuegbar_abstring(date)

Example:2026-11-01

energieausweisobject

Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.

Show Child Parameters
provisionobject
Show Child Parameters
idstring

Example:obj_8f2c1a

statusstring

Allowed values:entwurfaktivreserviertverkauftvermietetarchiviert

Example:aktiv

medien_anzahlinteger

Example:14

angelegt_amstring(date-time)

Example:2026-08-14T08:12:44Z

geaendert_amstring(date-time)

Example:2026-08-20T09:38:02Z

post/objekte

Body

{ "typ": "wohnung", "titel": "3-Zimmer-Altbau am Falkenried", "adresse": { "strasse": "Falkenried 42", "plz": "20251", "ort": "Hamburg" }, "wohnflaeche_qm": 86.5, "zimmer": 3, "baujahr": 1908, "kaufpreis_eur": 645000, "provision": { "kaeufer_prozent": 3.57, "verkaeufer_prozent": 3.57 } }
 
application/json

Objekt abrufen

get

Path Parameters

objektIdstringrequired

Example:obj_8f2c1a

Response

application/json

Objekt

Objekt

typstringrequired

Allowed values:wohnunghausgrundstueckgewerbestellplatz

Example:wohnung

titelstringrequired

<= 120 characters

Example:3-Zimmer-Altbau am Falkenried

beschreibungstring

Example:Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.

adresseobjectrequired
Show Child Parameters
wohnflaeche_qmnumber(float)

Example:86.5

grundstuecksflaeche_qmnumber(float)

Example:412

zimmernumber(float)

Example:3

baujahrinteger

Example:1908

etageinteger

Example:2

kaufpreis_eurinteger

Example:645000

kaltmiete_eurinteger

Example:1450

nebenkosten_eurinteger

Example:280

verfuegbar_abstring(date)

Example:2026-11-01

energieausweisobject

Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.

Show Child Parameters
provisionobject
Show Child Parameters
idstring

Example:obj_8f2c1a

statusstring

Allowed values:entwurfaktivreserviertverkauftvermietetarchiviert

Example:aktiv

medien_anzahlinteger

Example:14

angelegt_amstring(date-time)

Example:2026-08-14T08:12:44Z

geaendert_amstring(date-time)

Example:2026-08-20T09:38:02Z

get/objekte/{objektId}
 
application/json

Objekt ändern

Ändert einzelne Felder. Bereits erzeugte Exposés bleiben unverändert.

patch

Path Parameters

objektIdstringrequired

Example:obj_8f2c1a

Body

application/json

ObjektAnlegen

typstringrequired

Allowed values:wohnunghausgrundstueckgewerbestellplatz

Example:wohnung

titelstringrequired

<= 120 characters

Example:3-Zimmer-Altbau am Falkenried

beschreibungstring

Example:Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.

adresseobjectrequired
Show Child Parameters
wohnflaeche_qmnumber(float)

Example:86.5

grundstuecksflaeche_qmnumber(float)

Example:412

zimmernumber(float)

Example:3

baujahrinteger

Example:1908

etageinteger

Example:2

kaufpreis_eurinteger

Example:645000

kaltmiete_eurinteger

Example:1450

nebenkosten_eurinteger

Example:280

verfuegbar_abstring(date)

Example:2026-11-01

energieausweisobject

Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.

Show Child Parameters
provisionobject
Show Child Parameters

Response

application/json

Geändert

Objekt

typstringrequired

Allowed values:wohnunghausgrundstueckgewerbestellplatz

Example:wohnung

titelstringrequired

<= 120 characters

Example:3-Zimmer-Altbau am Falkenried

beschreibungstring

Example:Gepflegte Altbauwohnung im zweiten Obergeschoss mit zwei Südbalkonen.

adresseobjectrequired
Show Child Parameters
wohnflaeche_qmnumber(float)

Example:86.5

grundstuecksflaeche_qmnumber(float)

Example:412

zimmernumber(float)

Example:3

baujahrinteger

Example:1908

etageinteger

Example:2

kaufpreis_eurinteger

Example:645000

kaltmiete_eurinteger

Example:1450

nebenkosten_eurinteger

Example:280

verfuegbar_abstring(date)

Example:2026-11-01

energieausweisobject

Kennwerte, die für die Veröffentlichung eines Exposés benötigt werden.

Show Child Parameters
provisionobject
Show Child Parameters
idstring

Example:obj_8f2c1a

statusstring

Allowed values:entwurfaktivreserviertverkauftvermietetarchiviert

Example:aktiv

medien_anzahlinteger

Example:14

angelegt_amstring(date-time)

Example:2026-08-14T08:12:44Z

geaendert_amstring(date-time)

Example:2026-08-20T09:38:02Z

patch/objekte/{objektId}

Body

{ "kaufpreis_eur": 629000 }
 
application/json

Objekt archivieren

Nimmt das Objekt aus der Vermarktung. Der Datensatz bleibt lesbar.

delete

Path Parameters

objektIdstringrequired

Example:obj_8f2c1a

Response

Archiviert

delete/objekte/{objektId}
 

Medien