Marktwertermittlung

Marktwertermittlung

1.0.0OAS 3.0

Ermittelt eine erste Preisindikation für ein Objekt – aus Vergleichswerten der
Umgebung, dem örtlichen Mietspiegel und den Merkmalen des Objekts.

Das Ergebnis ist eine Indikation, kein Verkehrswertgutachten nach ImmoWertV.
Jede Antwort trägt deshalb eine Spanne und eine Angabe zur Datengrundlage, damit
im Kundengespräch klar bleibt, wie belastbar die Zahl ist.

API Base URL
  • Server 1:https://api.maklerportal.example/v1

    Produktion

  • Server 2:https://sandbox.api.maklerportal.example/v1

    Sandbox

Security
apiKey (apiKey)

Jeder Aufruf trägt einen API-Schlüssel im Header apikey. Den Schlüssel
erzeugen Sie im Maklerportal unter “Meine Anwendungen”; er wird genau einmal
angezeigt.

An jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,
antwortet die API mit 403 und code: "scope_fehlt"; der fehlende Scope
steht in details[].feld.

Additional Information
Contact API-Support Objektwerk GmbH (api-support@objektwerk.example)

Bewertungen

Bewertung anfordern

Startet eine Bewertung. Entweder für ein vorhandenes Objekt über objekt_id
oder für eine freie Eingabe über merkmale – etwa im Erstgespräch, bevor ein
Objekt angelegt wurde.

post

Body

application/json

BewertungAnfordern

Genau eines von objekt_id oder merkmale muss gesetzt sein.

objekt_idstring

Example:obj_8f2c1a

anlassstringrequired

Allowed values:erstgespraechverkaufvermietungfinanzierungerbschaft

Example:verkauf

merkmaleobject

Freie Objektbeschreibung, wenn kein Objektdatensatz vorliegt.

Show Child Parameters

Response

application/json

Bewertung erstellt

Bewertungsergebnis

idstring

Example:bwt_3e18

objekt_idstring | null

Example:obj_8f2c1a

anlassstring

Allowed values:erstgespraechverkaufvermietungfinanzierungerbschaft

Example:verkauf

marktwert_eurinteger

Example:638000

spanne_eurobject
Show Child Parameters
quadratmeterpreis_eurinteger

Example:7376

konfidenzstring

Belastbarkeit der Indikation.

Allowed values:niedrigmittelhoch

datengrundlageobject

Woraus die Indikation abgeleitet wurde.

Show Child Parameters
erstellt_amstring(date-time)

Example:2026-08-20T09:52:00Z

post/bewertungen

Body

{ "objekt_id": "obj_8f2c1a", "anlass": "verkauf" }
 
application/json

Bewertung abrufen

get

Path Parameters

bewertungIdstringrequired

Example:bwt_3e18

Response

application/json

Bewertung

Bewertungsergebnis

idstring

Example:bwt_3e18

objekt_idstring | null

Example:obj_8f2c1a

anlassstring

Allowed values:erstgespraechverkaufvermietungfinanzierungerbschaft

Example:verkauf

marktwert_eurinteger

Example:638000

spanne_eurobject
Show Child Parameters
quadratmeterpreis_eurinteger

Example:7376

konfidenzstring

Belastbarkeit der Indikation.

Allowed values:niedrigmittelhoch

datengrundlageobject

Woraus die Indikation abgeleitet wurde.

Show Child Parameters
erstellt_amstring(date-time)

Example:2026-08-20T09:52:00Z

get/bewertungen/{bewertungId}
 
application/json

Vergleichswerte