---
title: "Marktwertermittlung"
url: "https://maklerportal.apim.eu/apis/marktwertermittlung/versions/cb8e224b-f566-49d5-9923-11559fca3319"
---

# Marktwertermittlung

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Marktwertermittlung","version":"1.0.0","description":"Ermittelt eine erste Preisindikation für ein Objekt – aus Vergleichswerten der\nUmgebung, dem örtlichen Mietspiegel und den Merkmalen des Objekts.\n\nDas Ergebnis ist eine **Indikation**, kein Verkehrswertgutachten nach ImmoWertV.\nJede Antwort trägt deshalb eine Spanne und eine Angabe zur Datengrundlage, damit\nim Kundengespräch klar bleibt, wie belastbar die Zahl ist.\n","contact":{"name":"API-Support Objektwerk GmbH","email":"api-support@objektwerk.example"}},"servers":[{"url":"https://api.maklerportal.example/v1","description":"Produktion"},{"url":"https://sandbox.api.maklerportal.example/v1","description":"Sandbox"}],"tags":[{"name":"Bewertungen"},{"name":"Vergleichswerte"},{"name":"Mietspiegel"}],"security":[{"apiKey":[]}],"paths":{"/bewertungen":{"post":{"tags":["Bewertungen"],"summary":"Bewertung anfordern","description":"Startet eine Bewertung. Entweder für ein vorhandenes Objekt über `objekt_id`\noder für eine freie Eingabe über `merkmale` – etwa im Erstgespräch, bevor ein\nObjekt angelegt wurde.\n","operationId":"bewertungAnfordern","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BewertungAnfordern"},"examples":{"bestandsobjekt":{"summary":"Für ein bereits angelegtes Objekt","value":{"objekt_id":"obj_8f2c1a","anlass":"verkauf"}},"freieEingabe":{"summary":"Im Erstgespräch, ohne Objektdatensatz","value":{"anlass":"erstgespraech","merkmale":{"typ":"wohnung","plz":"20251","wohnflaeche_qm":86.5,"zimmer":3,"baujahr":1908,"zustand":"gepflegt","ausstattung":"gehoben"}}}}}}},"responses":{"201":{"description":"Bewertung erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bewertungsergebnis"},"example":{"id":"bwt_3e18","anlass":"verkauf","marktwert_eur":638000,"spanne_eur":{"von":602000,"bis":674000},"quadratmeterpreis_eur":7376,"konfidenz":"mittel","datengrundlage":{"vergleichsobjekte":23,"zeitraum_monate":12,"radius_meter":1200},"erstellt_am":"2026-08-20T09:52:00Z"}}}},"400":{"$ref":"#/components/responses/Validierungsfehler"},"422":{"description":"Datengrundlage zu dünn für eine Indikation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"},"example":{"code":"datengrundlage_unzureichend","nachricht":"Für diese Lage liegen zu wenige Vergleichsobjekte vor.","details":[{"feld":"vergleichsobjekte","grund":"unter_mindestanzahl"}]}}}}}}},"/bewertungen/{bewertungId}":{"parameters":[{"name":"bewertungId","in":"path","required":true,"schema":{"type":"string","example":"bwt_3e18"}}],"get":{"tags":["Bewertungen"],"summary":"Bewertung abrufen","operationId":"bewertungAbrufen","responses":{"200":{"description":"Bewertung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bewertungsergebnis"}}}},"404":{"$ref":"#/components/responses/NichtGefunden"}}}},"/vergleichswerte":{"get":{"tags":["Vergleichswerte"],"summary":"Vergleichsobjekte abfragen","description":"Anonymisierte Abschlüsse aus der Umgebung. Adressen werden auf Straßenebene\ngerundet, damit keine Rückschlüsse auf einzelne Verkäufe möglich sind.\n","operationId":"vergleichswerteAbfragen","parameters":[{"name":"plz","in":"query","required":true,"schema":{"type":"string","example":"20251"}},{"name":"typ","in":"query","required":true,"schema":{"type":"string","enum":["wohnung","haus","grundstueck","gewerbe"]}},{"name":"wohnflaeche_qm","in":"query","description":"Referenzfläche; gesucht wird in einem Korridor von ±20 Prozent.","schema":{"type":"number","format":"float","example":86.5}},{"name":"zeitraum_monate","in":"query","schema":{"type":"integer","minimum":3,"maximum":36,"default":12}}],"responses":{"200":{"description":"Vergleichsobjekte","content":{"application/json":{"schema":{"type":"object","properties":{"daten":{"type":"array","items":{"$ref":"#/components/schemas/Vergleichsobjekt"}},"kennzahlen":{"$ref":"#/components/schemas/Kennzahlen"}}}}}},"401":{"$ref":"#/components/responses/NichtAuthentifiziert"}}}},"/mietspiegel":{"get":{"tags":["Mietspiegel"],"summary":"Mietspiegelwerte abfragen","description":"Ortsübliche Vergleichsmiete auf Basis des amtlichen Mietspiegels.","operationId":"mietspiegelAbfragen","parameters":[{"name":"plz","in":"query","required":true,"schema":{"type":"string","example":"20251"}},{"name":"wohnflaeche_qm","in":"query","required":true,"schema":{"type":"number","format":"float","example":86.5}},{"name":"baujahr","in":"query","schema":{"type":"integer","example":1908}}],"responses":{"200":{"description":"Mietspiegelwerte","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mietspiegelwert"},"example":{"ort":"Hamburg","stand":"2025-01-01","nettokaltmiete_qm_eur":{"unten":9.4,"mittel":11.8,"oben":14.6},"spanne_hinweis":"Werte gelten für normale Wohnlage ohne Aufschläge."}}}},"404":{"$ref":"#/components/responses/NichtGefunden"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"apikey","description":"Jeder Aufruf trägt einen API-Schlüssel im Header `apikey`. Den Schlüssel\nerzeugen Sie im Maklerportal unter \"Meine Anwendungen\"; er wird genau einmal\nangezeigt.\n\nAn jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,\nantwortet die API mit `403` und `code: \"scope_fehlt\"`; der fehlende Scope\nsteht in `details[].feld`.\n"}},"responses":{"NichtAuthentifiziert":{"description":"Schlüssel fehlt, ist gesperrt oder ungültig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"NichtGefunden":{"description":"Datensatz nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"Validierungsfehler":{"description":"Die Anfrage entspricht nicht dem Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"ZuVieleAnfragen":{"description":"Rate Limit erreicht","headers":{"Retry-After":{"schema":{"type":"integer","example":12}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}}},"schemas":{"Seite":{"type":"object","description":"Cursor-basierte Paginierung.","properties":{"anzahl":{"type":"integer","example":25},"gesamt":{"type":"integer","example":138},"cursor_naechste":{"type":"string","nullable":true,"example":"eyJzIjoyNX0"}}},"Fehlerdetail":{"type":"object","properties":{"feld":{"type":"string","example":"energieausweis.endenergiebedarf_kwh"},"grund":{"type":"string","example":"fehlt"}}},"Fehler":{"type":"object","description":"Einheitliches Fehlerformat aller Maklerportal-APIs.","required":["code","nachricht"],"properties":{"code":{"type":"string","example":"validierung_fehlgeschlagen"},"nachricht":{"type":"string","example":"Für die Veröffentlichung fehlen Pflichtangaben aus dem Energieausweis."},"details":{"type":"array","items":{"$ref":"#/components/schemas/Fehlerdetail"}}}},"Anlass":{"type":"string","enum":["erstgespraech","verkauf","vermietung","finanzierung","erbschaft"],"example":"verkauf"},"Merkmale":{"type":"object","description":"Freie Objektbeschreibung, wenn kein Objektdatensatz vorliegt.","required":["typ","plz","wohnflaeche_qm"],"properties":{"typ":{"type":"string","enum":["wohnung","haus","grundstueck","gewerbe"]},"plz":{"type":"string","pattern":"^[0-9]{5}$","example":"20251"},"wohnflaeche_qm":{"type":"number","format":"float","example":86.5},"grundstuecksflaeche_qm":{"type":"number","format":"float","example":412},"zimmer":{"type":"number","format":"float","example":3},"baujahr":{"type":"integer","example":1908},"zustand":{"type":"string","enum":["renovierungsbeduerftig","gepflegt","modernisiert","neuwertig"]},"ausstattung":{"type":"string","enum":["einfach","normal","gehoben","luxus"]},"balkon":{"type":"boolean","example":true},"aufzug":{"type":"boolean","example":false},"stellplatz":{"type":"boolean","example":false}}},"BewertungAnfordern":{"type":"object","required":["anlass"],"description":"Genau eines von `objekt_id` oder `merkmale` muss gesetzt sein.","properties":{"objekt_id":{"type":"string","example":"obj_8f2c1a"},"anlass":{"$ref":"#/components/schemas/Anlass"},"merkmale":{"$ref":"#/components/schemas/Merkmale"}}},"Spanne":{"type":"object","properties":{"von":{"type":"integer","example":602000},"bis":{"type":"integer","example":674000}}},"Datengrundlage":{"type":"object","description":"Woraus die Indikation abgeleitet wurde.","properties":{"vergleichsobjekte":{"type":"integer","example":23},"zeitraum_monate":{"type":"integer","example":12},"radius_meter":{"type":"integer","example":1200}}},"Bewertungsergebnis":{"type":"object","properties":{"id":{"type":"string","example":"bwt_3e18"},"objekt_id":{"type":"string","nullable":true,"example":"obj_8f2c1a"},"anlass":{"$ref":"#/components/schemas/Anlass"},"marktwert_eur":{"type":"integer","example":638000},"spanne_eur":{"$ref":"#/components/schemas/Spanne"},"quadratmeterpreis_eur":{"type":"integer","example":7376},"konfidenz":{"type":"string","description":"Belastbarkeit der Indikation.","enum":["niedrig","mittel","hoch"]},"datengrundlage":{"$ref":"#/components/schemas/Datengrundlage"},"erstellt_am":{"type":"string","format":"date-time","example":"2026-08-20T09:52:00Z"}}},"Vergleichsobjekt":{"type":"object","properties":{"strasse_gerundet":{"type":"string","example":"Falkenried"},"wohnflaeche_qm":{"type":"number","format":"float","example":82},"zimmer":{"type":"number","format":"float","example":3},"baujahr":{"type":"integer","example":1911},"kaufpreis_eur":{"type":"integer","example":615000},"quadratmeterpreis_eur":{"type":"integer","example":7500},"abschluss_monat":{"type":"string","example":"2026-03"}}},"Kennzahlen":{"type":"object","properties":{"anzahl":{"type":"integer","example":23},"median_qm_eur":{"type":"integer","example":7410},"unteres_quartil_qm_eur":{"type":"integer","example":6980},"oberes_quartil_qm_eur":{"type":"integer","example":7860}}},"Mietspiegelwert":{"type":"object","properties":{"ort":{"type":"string","example":"Hamburg"},"stand":{"type":"string","format":"date","example":"2025-01-01"},"nettokaltmiete_qm_eur":{"type":"object","properties":{"unten":{"type":"number","format":"float","example":9.4},"mittel":{"type":"number","format":"float","example":11.8},"oben":{"type":"number","format":"float","example":14.6}}},"spanne_hinweis":{"type":"string","example":"Werte gelten für normale Wohnlage ohne Zu- oder Abschläge."}}}}}}
```