Immowert123
API docs by Redocly

Immowert123 Integration API (1.0.0)

Download OpenAPI specification:

Integration der REST API für Immobilienbewertungen.

Aufruf erfolgt mittels Authentifizierung mit dem zur Verfügung gestellten API-Key über den X-API-Key Header.

Alle erfolgreichen Responses haben die folgende Struktur: status, code, message, data.

Rate-Limits (pro API-Key; alle Zeitfenster einer Regel gelten gleichzeitig):

Regel 60 Sekunden 1 Stunde 1 Tag Endpunkte
Standard (Lesen) max. 180 max. 2000 max. 10000 GET /bewertung, GET /bewertungen
Schreiben max. 60 max. 300 max. 1000 POST /bewertung, POST /bewertung/upload
PDF max. 3 max. 30 max. 100 GET /bewertung/pdf

Bei Überschreitung wird HTTP 429 zurückgegeben.

Gleichzeitigkeit: max. 3 gleichzeitige Requests pro API-Key. Nach 60 Sekunden wird ein laufender API-Aufruf als abgelaufen betrachtet und der Counter zurückgesetzt.

Bewertung anlegen

Legt eine neue Immobilienbewertung an.

Alle über die API angelegten Bewertungen erscheinen in Ihrem Immowert123-Konto unter „offene Bewertungen“ und werden mit „API“ markiert.

API-Limits: Es können maximal 20 Bewertungen über die API angelegt bzw. importiert werden. Um dieses Limit wieder freizugeben, müssen die Bewertungen anschließend manuell im Immowert123-Konto vervollständigt und abgeschlossen oder alternativ gelöscht werden. Jede abgeschlossene Bewertung reduziert das gebuchte Immowert123-Kontingent um 1 und zählt wie eine normal über die Plattform getätigte Bewertung.

Authorizations:
apiKeyAuth
Request Body schema: application/json
required
immobilienart
required
string
Enum: "haus" "wohnung" "grundstueck"

Art der zu bewertenden Immobilie

bewertungsverfahren
required
string
Enum: "sachwertverfahren" "vergleichswertverfahren" "ertragswertverfahren"

Verfahren zur Bewertung der Immobilie

required
object (Adresse)

Adress- und Standortdaten der Immobilie

object (Auftraggeber)

Daten des Auftraggebers der Bewertung

object (Grundbuch)

Grundbuchdaten der Immobilie

Array of objects (BodenFlaeche)

Bodenflächen des Grundstücks

Array of objects (Gebaeude)

Responses

Request samples

Content type
application/json
{
  • "immobilienart": "haus",
  • "bewertungsverfahren": "sachwertverfahren",
  • "adresse": {
    },
  • "auftraggeber": {
    },
  • "grundbuch": {
    },
  • "boden": [
    ],
  • "gebaeude": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "success",
  • "code": 201,
  • "message": "Bewertung erfolgreich angelegt",
  • "data": {
    }
}

Bewertung abrufen

Liefert eine einzelne Immobilienbewertung als vollständiges JSON-Objekt.

Die Identifikation erfolgt über den Query-Parameter ref (Referenznummer aus Response von POST /bewertung).

Authorizations:
apiKeyAuth
query Parameters
ref
required
string
Example: ref=6A0F060D65A9E

Referenznummer der Bewertung (aus Response von POST /bewertung)

Responses

Request samples 

curl -sS --request GET \
  --url 'https://immowert123.at/api/ext/v1/bewertung?ref=6A0F060D65A9E' \
  --header 'X-API-Key: YOUR_API_KEY' \
  | jq -e '.status == "success" and .code == 200'

Response samples

Content type
application/json
{
  • "status": "success",
  • "code": 200,
  • "message": "",
  • "data": {
    }
}

Bewertungen auflisten

Liefert eine gekürzte Übersichtsliste der Immobilienbewertungen des authentifizierten API-Benutzers.

Die Ergebnisse können optional gefiltert und paginiert werden.

Authorizations:
apiKeyAuth
query Parameters
typ
string
Enum: "haus" "wohnung" "grundstueck" "sonstiges_gebaeude"

Filter nach Immobilienart

bewertungsdatum-von
string <date>
Example: bewertungsdatum-von=2026-07-01

Filter Bewertungsdatum ab (YYYY-MM-DD)

bewertungsdatum-bis
string <date>
Example: bewertungsdatum-bis=2026-07-31

Filter Bewertungsdatum bis (YYYY-MM-DD)

erstellungsdatum-von
string <date>
Example: erstellungsdatum-von=2026-07-01

Filter Erstellungsdatum ab (YYYY-MM-DD)

erstellungsdatum-bis
string <date>
Example: erstellungsdatum-bis=2026-07-31

Filter Erstellungsdatum bis (YYYY-MM-DD)

abgeschlossen
boolean

true = nur abgeschlossene Bewertungen, false = nur offene Bewertungen

plz
integer
Example: plz=9020

Postleitzahl der Immobilie

sort
Array of strings
Items Enum: "bewertungsdatum:asc" "bewertungsdatum:desc" "erstellungsdatum:asc" "erstellungsdatum:desc" "verkehrswert:asc" "verkehrswert:desc"
Example: sort=bewertungsdatum:asc

Sortierung als feld:richtung. Für mehrstufige Sortierung den Parameter mehrfach übergeben (Reihenfolge wird beibehalten).

start
integer >= 0
Default: 0

Pagination-Offset (erster Eintrag = 0)

limit
integer [ 1 .. 100 ]
Default: 20
Example: limit=20

Anzahl Einträge pro Seite

Responses

Request samples 

curl -sS --request GET \
  --url 'https://immowert123.at/api/ext/v1/bewertungen?typ=haus&bewertungsdatum-von=2026-07-01&bewertungsdatum-bis=2026-07-31&abgeschlossen=true&sort=bewertungsdatum:asc&start=0&limit=20' \
  --header 'X-API-Key: YOUR_API_KEY' \
  | jq -e '.status == "success" and .code == 200'

Response samples

Content type
application/json
{
  • "status": "success",
  • "code": 200,
  • "message": "",
  • "data": {
    }
}

Bilder hochladen

Lädt ein einzelnes Bild zu einer bestehenden Bewertung hoch.

Die Identifikation der Bewertung erfolgt mittels referenz_nr (aus Response von POST /bewertung).

Request als multipart/form-data. Die Datei wird immer im Formularfeld datei übermittelt; der Upload-Typ wird über typ gesteuert.

Erlaubte Formate: JPEG, PNG, GIF, PDF. Pro Request ist genau eine Datei erlaubt.

Kontingente pro Bewertung: bild max. 35, plan max. 10, anhang max. 10.

Authorizations:
apiKeyAuth
Request Body schema: multipart/form-data
required
referenz_nr
required
string

Zuordnung des Uploads zur Referenznummer der Bewertung (aus Response von POST /bewertung)

typ
string
Default: "bild"
Enum: "bild" "plan" "anhang"

Kategorisierung des Uploads zum entsprechenden Bild-Typ

beschreibung
string

Beschreibung des Uploads

datei
required
string <binary>

Bild- oder PDF-Datei (Formularfeld immer datei).

Unterstützte Dateitypen: jpg, gif, png, pdf.

Erlaubte MIME-Typen: image/jpeg, image/png, image/gif, application/pdf.

Kontingente pro Bewertung: bild max. 35, plan max. 10, anhang max. 10.

Responses

Request samples 

curl -sS --request POST \
  --url 'https://immowert123.at/api/ext/v1/bewertung/upload' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --form 'referenz_nr=6A0F060D65A9E' \
  --form 'typ=bild' \
  --form 'beschreibung=Bildbeschreibung' \
  --form 'datei=@/path/to/photo.jpg;type=image/jpeg' \
  | jq -e '.status == "success" and .code == 201'

Response samples

Content type
application/json
{
  • "status": "success",
  • "code": 201,
  • "message": "Bild erfolgreich hochgeladen",
  • "data": {
    }
}

Bewertung als PDF

Liefert die Immobilienbewertung als PDF-Datei (Binärdaten).

Voraussetzung: Die Immobilienbewertung muss bereits abgeschlossen sein, um das PDF-Dokument abrufen zu können.

Die Identifikation erfolgt über den Query-Parameter ref (Referenznummer aus Response von POST /bewertung).

Bei Erfolg: Content-Type: application/pdf (kein JSON-Envelope). Der Dateiname wird im Header Content-Disposition übermittelt.

Bei Fehler: JSON-Response mit status, code, message, data (wie bei den anderen Endpunkten).

Authorizations:
apiKeyAuth
query Parameters
ref
required
string
Example: ref=6A0F060D65A9E

Referenznummer der Bewertung (aus Response von POST /bewertung)

Responses

Request samples 

curl --request GET \
  --url 'https://immowert123.at/api/ext/v1/bewertung/pdf?ref=6A0F060D65A9E' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --output bewertung.pdf

Response samples

Content type
application/json
{
  • "status": "error",
  • "code": 0,
  • "message": "string",
  • "data": [
    ]
}