API für Immobilien API für Makler und Bauträger
Objekte direkt aus Ihrer Website, Ihrem CRM oder einem Skript liefern und Anfragen auf demselben Weg abholen. Ein Schlüssel, JSON, fertig.
Stand
curl -X PUT "https://api.immoriver.com/v1/objekte/DOKU-4711?warten=20" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data @objekt.json
Inhalt
- Überblick
- Schnellstart
- Schlüssel und Anmeldung
- Objekte liefern
- Bilder und Dokumente
- Status und Veröffentlichung
- Lieferungen und Ergebnisse
- Objekte abrufen
- Anfragen abholen
- Werte und IDs
- Feldreferenz
- Objektarten und Untertypen
- Fehler
- Grenzen
- OpenImmo und FTP
- ChatGPT und KI-Assistenten (MCP)
- Code-Beispiele
- Versionen
Überblick
Die API ist ein Lieferweg wie FTP, nur ohne Maklerprogramm: Sie senden ein Objekt als JSON, wir prüfen es sofort, spielen es ein und schalten es frei, sobald alle Pflichtangaben da sind und Ihr Paket Platz hat. Anfragen von Interessenten holen Sie als Änderungsstrom ab und melden den Bearbeitungsstand zurück.
| Adresse | https://api.immoriver.com/v1 |
|---|---|
| Format | JSON (UTF-8), Zahlen mit Punkt, Datum JJJJ-MM-TT, Zeiten ISO 8601 |
| Anmeldung | Authorization: Bearer ir_live_… |
| Voraussetzung | Ein laufendes Makler- oder Bauträgerpaket und eine geprüfte Firma |
| Sprache der Meldungen | Accept-Language: en für Englisch, sonst Deutsch. Feldnamen und Codes sind in beiden gleich. |
| OpenAPI 3.1 | openapi.json herunterladen (auch unter https://api.immoriver.com/v1/openapi.json) |
Wer schon einmal eine OpenImmo-Datei gebaut hat, erkennt die Feldnamen wieder; die Feldreferenz nennt zu jedem Feld die Stelle im OpenImmo-Dokument. Ihr JSON nimmt danach denselben Weg wie eine FTP-Lieferung.
Schnellstart
- Schlüssel anlegen: Im Konto unter Transfer, Abschnitt „Schnittstelle (API)“. Zum Ausprobieren nehmen Sie einen Testschlüssel; damit angelegte Objekte bleiben Entwurf. Zum Konto
- Verbindung prüfen:
curl -X GET "https://api.immoriver.com/v1" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 120
RateLimit-Remaining: 119
RateLimit-Reset: 22
{
"api": "immoriver",
"version": "v1",
"feldkatalog": "1.0",
"firma": {
"name": "Beispiel Immobilien GmbH",
"firmennummer": 2010099,
"anbieterkennung": "IR-2010099"
},
"schluessel": {
"name": "Website",
"praefix": "ir_live_3f9a1c77",
"modus": "live",
"rechte": [
"objekte:schreiben",
"objekte:lesen",
"anfragen:lesen",
"anfragen:schreiben"
]
},
"kontingent": {
"paket": "makler_business",
"grenze": 50,
"aktiv": 37,
"frei": 13
},
"grenzen": {
"je_minute": {
"lesen": 120,
"schreiben": 60,
"medien": 30
},
"je_tag": 20000
},
"doku": "https://immoriver.com/entwickler"
} - Das erste Objekt liefern. Die Kennung im Pfad (hier DOKU-4711) ist Ihre eigene, dauerhafte ID des Objekts. Mit ?warten=20 wartet der Aufruf auf das Ergebnis:
objekt.json
{
"status": "aktiv",
"objektkategorie": {
"nutzungsart": [
"WOHNEN"
],
"vermarktungsart": [
"KAUF"
],
"objektart": {
"typ": "wohnung",
"untertyp": "ETAGE"
}
},
"geo": {
"plz": "50667",
"ort": "Köln",
"strasse": "Domkloster",
"hausnummer": "4",
"land": "DEU",
"regionaler_zusatz": "Altstadt-Nord",
"etage": 2,
"anzahl_etagen": 5
},
"kontaktperson": {
"anrede": "Frau",
"vorname": "Anna",
"name": "Berger",
"email_zentrale": "info@beispiel-immobilien.de",
"tel_durchw": "+49 221 123456-12"
},
"preise": {
"kaufpreis": 489000,
"waehrung": "EUR",
"hausgeld": 310,
"provisionspflichtig": true,
"aussen_courtage": "3,57 %",
"aussen_courtage_mit_mwst": true,
"stellplaetze": [
{
"art": "TIEFGARAGE",
"anzahl": 1,
"kaufpreis": 25000
}
]
},
"flaechen": {
"wohnflaeche": 92.5,
"anzahl_zimmer": 3,
"anzahl_schlafzimmer": 2,
"anzahl_badezimmer": 1,
"anzahl_balkone": 1
},
"ausstattung": {
"ausstatt_kategorie": "GEHOBEN",
"heizungsart": [
"ZENTRAL",
"FUSSBODEN"
],
"befeuerung": [
"GAS"
],
"kueche": [
"EBK"
],
"boden": [
"PARKETT",
"FLIESEN"
],
"fahrstuhl": [
"PERSONEN"
],
"unterkellert": "JA",
"gaestewc": true,
"ausricht_balkon_terrasse": [
"SUEDWEST"
]
},
"zustand_angaben": {
"baujahr": 1998,
"zustand": "GEPFLEGT",
"energiepass": {
"epart": "VERBRAUCH",
"jahrgang": "2014",
"gebaeudeart": "wohn",
"energieverbrauchkennwert": 98.4,
"primaerenergietraeger": "GAS",
"wertklasse": "C",
"mitwarmwasser": true,
"gueltig_bis": "2031-05-01"
}
},
"freitexte": {
"objekttitel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer",
"objektbeschreibung": "Die Wohnung liegt im zweiten Obergeschoss eines gepflegten Hauses von 1998.\n\nWohnzimmer und Küche öffnen sich zum Südwestbalkon.",
"lage": "Dom, Rheinufer und Hauptbahnhof erreichen Sie zu Fuß."
},
"anhaenge": [
{
"gruppe": "TITELBILD",
"titel": "Ansicht",
"url": "https://immoriver.com/assets/bilder/teilen.jpg"
}
],
"verwaltung_objekt": {
"verfuegbar_ab": "nach Vereinbarung",
"objektadresse_freigeben": false
},
"verwaltung_techn": {
"objektnr_extern": "W-4711"
}
}curl -X PUT "https://api.immoriver.com/v1/objekte/DOKU-4711?warten=20" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data @objekt.jsonAntwort
HTTP 200
Content-Type: application/json; charset=UTF-8
Content-Location: /v1/lieferungen/65799886
RateLimit-Limit: 60
RateLimit-Remaining: 58
RateLimit-Reset: 20
{
"lieferung": "65799886",
"status": "erfolgreich",
"kanal": "api",
"erstellt": "2026-09-26T01:02:38+02:00",
"beendet": "2026-09-26T01:02:40+02:00",
"objekte_gesamt": 1,
"medien": 1,
"fehler": null,
"objekte": [
{
"obid": "DOKU-4711",
"objektnr_extern": "W-4711",
"expose_nr": 112173,
"ergebnis": "neu",
"status": "aktiv",
"freigabe": "aktiv",
"fehlend": [],
"meldung": null,
"url": "https://immoriver.com/expose/112173"
}
],
"hinweise": [],
"testmodus": false
} Das Objekt steht jetzt unter der Adresse in url online. Dasselbe PUT noch einmal ändert nichts (ergebnis „unveraendert“); ein geändertes PUT ersetzt das Objekt vollständig.
Schlüssel und Anmeldung
Jede Anfrage trägt den Schlüssel als Bearer-Token. Wo ein Proxy die Authorization-Kopfzeile verliert, geht auch X-Api-Key: ir_live_…. Schlüssel gehören zur Firma, nicht zu einer Person. Wir speichern nur eine Prüfsumme: Der Klartext erscheint einmal beim Anlegen.
| Recht | Erlaubt |
|---|---|
objekte:schreiben | Objekte anlegen, ändern, löschen, Status setzen |
objekte:lesen | Eigene Objekte und Lieferungen abrufen |
anfragen:lesen | Anfragen zu eigenen Objekten abrufen |
anfragen:schreiben | Bearbeitungsstand von Anfragen zurückmelden |
- ir_live_…: Objekte gehen online wie über das Portal.
- ir_test_…: Alles funktioniert gleich, aber Objekte bleiben Entwurf und werden nie veröffentlicht. Status „aktiv“ wird mit 403 abgewiesen.
- Optional lässt sich ein Schlüssel auf IP-Adressen oder Netze beschränken.
- Ein widerrufener Schlüssel gilt sofort nicht mehr. Nach 20 ungültigen Schlüsseln in zehn Minuten sperren wir die IP für zehn Minuten.
curl -X GET "https://api.immoriver.com/v1"Antwort anzeigen (HTTP 401)
HTTP 401
Content-Type: application/problem+json; charset=UTF-8
{
"type": "https://immoriver.com/entwickler#fehler-schluessel_fehlt",
"title": "Schlüssel fehlt",
"status": 401,
"code": "schluessel_fehlt",
"detail": "Senden Sie Ihren Schlüssel als „Authorization: Bearer ir_live_…“.",
"anfrage_id": "00MUHKGBGLD75B44A742E9609C"
}Objekte liefern
PUT /v1/objekte/{obid} legt ein Objekt an oder ersetzt es vollständig. Die obid wählen Sie selbst (Buchstaben, Ziffern, Punkt, Bindestrich, Unterstrich, bis 100 Zeichen) und behalten sie für die Lebensdauer des Objekts. Was im Körper fehlt, ist danach auch im Objekt leer.
Was sofort geprüft wird
Typen, Längen, Wertebereiche, erlaubte Werte, Pflichtfelder und unbekannte Felder. Alle Fehler kommen auf einmal zurück, mit Pfad und Code. Ein unbekanntes Feld ist ein Fehler und wird nicht still übergangen: Ein Tippfehler soll beim ersten Aufruf auffallen.
curl -X PUT "https://api.immoriver.com/v1/objekte/DOKU-4711" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data '{"objektkategorie":{"vermarktungsart":["KAUF"],"objektart":{"typ":"wohnung","untertyp":"VILLA"}},"geo":{"plz":"50667","ort":"Köln"},"preise":{"kaufpreis":"489.000 €","provisionspflichtig":true},"flaechen":{"wohnflaech":92.5},"freitexte":{"objekttitel":"Helle 3-Zimmer-Wohnung"}}'Antwort anzeigen (HTTP 422)
HTTP 422
Content-Type: application/problem+json; charset=UTF-8
RateLimit-Limit: 60
RateLimit-Remaining: 59
RateLimit-Reset: 22
{
"type": "https://immoriver.com/entwickler#fehler-pruefung_fehlgeschlagen",
"title": "Prüfung fehlgeschlagen",
"status": 422,
"code": "pruefung_fehlgeschlagen",
"detail": "Mindestens ein Feld ist fehlerhaft, siehe fehler.",
"anfrage_id": "00MUHKGBHI0F48A65C9EFC6F30",
"fehler": [
{
"pfad": "preise.kaufpreis",
"code": "typ_zahl",
"meldung": "Erwartet wird eine Zahl (Punkt als Dezimalzeichen, ohne Tausendertrenner)."
},
{
"pfad": "flaechen.wohnflaech",
"code": "unbekanntes_feld",
"meldung": "Unbekanntes Feld. Die erlaubten Felder stehen unter GET /v1/feldkatalog."
},
{
"pfad": "objektkategorie.nutzungsart",
"code": "pflichtfeld",
"meldung": "Pflichtfeld fehlt."
},
{
"pfad": "objektkategorie.objektart.untertyp",
"code": "unbekannter_wert",
"meldung": "Unbekannter Wert. Erlaubt: DACHGESCHOSS, MAISONETTE, LOFT-STUDIO-ATELIER, PENTHOUSE, TERRASSEN, ETAGE, ERDGESCHOSS, SOUTERRAIN, APARTMENT, FERIENWOHNUNG, GALERIE, ROHDACHBODEN, ATTIKAWOHNUNG, KEINE_ANGABE"
}
],
"hinweise": [
{
"pfad": "preise.kaufpreis",
"code": "preis_fehlt",
"meldung": "Ohne Preis (oder kaufpreis_auf_anfrage) bleibt das Objekt Entwurf."
},
{
"pfad": "anhaenge",
"code": "ohne_bild",
"meldung": "Ohne Bild bleibt das Objekt Entwurf."
}
]
}Immer Pflicht
objektkategorie.nutzungsart, objektkategorie.vermarktungsart, objektkategorie.objektart.typ, geo.plz, geo.ort, preise.provisionspflichtig, freitexte.objekttitel. provisionspflichtig ist Pflicht, weil sich „provisionsfrei“ sonst nicht von „nicht angegeben“ unterscheiden ließe.
Zahlen, Texte, Listen
- Zahlen als JSON-Zahlen: 489000 und 92.5, nicht „489.000 €“. Mehr Nachkommastellen als das Feld fasst werden gerundet.
- Ja/Nein als true oder false. null oder ein leerer Text heißt „keine Angabe“.
- Mehrfachwerte (etwa heizungsart) als Liste: ["ZENTRAL", "FUSSBODEN"]. Der erste Wert gilt als Hauptwert. Die OpenImmo-Schreibweise {"ZENTRAL": true} wird ebenfalls verstanden.
- Texte ohne HTML. Absätze trennen Sie mit einer Leerzeile (\n\n).
- Aufzählungswerte unabhängig von Groß- und Kleinschreibung; zurück kommen sie in der Schreibweise der Wertelisten.
Asynchron verarbeitet
Nach der Prüfung antwortet die API mit 202 und dem Stand der Lieferung. Geocodierung und Bildabruf laufen danach, meist in einer bis drei Sekunden. Mit ?warten=N (bis 25 Sekunden) wartet der Aufruf und antwortet mit 200 und dem Ergebnis. Den Stand fragen Sie sonst unter der Adresse in Content-Location ab.
Dasselbe Objekt über FTP und API
Liefert Ihre Firma ein Objekt auch per FTP, meint dieselbe openimmo_obid dasselbe Objekt: Die zweite Lieferung aktualisiert es. Über objektnr_extern gilt ein Objekt nur dann als dasselbe, wenn Objektart, Vermarktungsart und Postleitzahl übereinstimmen; sonst entsteht ein neues.
Kontaktperson
Anfragen zu einem Objekt gehen an die E-Mail der Kontaktperson (email_direkt, sonst email_zentrale), ohne Kontaktperson an die Adresse Ihrer Firma. Gibt es zu der Adresse noch kein Konto, legen wir ein vorgemerktes Teammitglied an, das Sie unter Konto › Team bestätigen oder ablehnen. Das ist dasselbe Verhalten wie bei FTP.
Löschen
DELETE /v1/objekte/{obid} nimmt das Objekt sofort offline und archiviert es; Bilder verschwinden vom CDN. Anfragen dazu bleiben erhalten. Ein späteres PUT mit derselben obid stellt es wieder ein.
curl -X DELETE "https://api.immoriver.com/v1/objekte/DOKU-4711" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 60
RateLimit-Remaining: 51
RateLimit-Reset: 17
{
"obid": "DOKU-4711",
"status": {
"id": 26007,
"code": "archiviert",
"text": "Archiviert"
},
"vorher": {
"id": 26002,
"code": "aktiv",
"text": "Aktiv"
}
}Bilder und Dokumente
anhaenge ist die vollständige Liste in Anzeigereihenfolge. Was bei der nächsten Lieferung fehlt, wird entfernt. Scheitert der Abruf eines Bildes, bleibt das bisherige stehen, und die nächste Lieferung versucht es erneut.
- Per Adresse: {"gruppe": "BILD", "url": "https://…"}. Wir laden das Bild (bis 20 MB, 15 Sekunden, nur öffentliche Adressen über http/https).
- Per Upload, wenn Ihre Bilder nicht öffentlich liegen: POST /v1/medien, dann {"medien_id": "med_…"}. Unbenutzte Uploads verfallen nach sieben Tagen.
- Erlaubt sind JPEG, PNG, WebP und PDF, Bilder ab 200 × 150 Pixel. Der Typ wird am Inhalt erkannt.
- Gruppen: TITELBILD, BILD, INNENANSICHTEN, AUSSENANSICHTEN, GRUNDRISS, KARTEN_LAGEPLAN, DOKUMENTE, PANORAMA, FILMLINK, LINKS. TITELBILD ist das erste Bild der Anzeige; ohne TITELBILD gilt das erste Bild. Rundgänge (Matterport, Ogulo u. a.) und Videos als PANORAMA oder FILMLINK mit url.
curl -X POST "https://api.immoriver.com/v1/medien" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "X-Dateiname: wohnzimmer.jpg" \
--data-binary @wohnzimmer.jpgAntwort
HTTP 201
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 30
RateLimit-Remaining: 29
RateLimit-Reset: 19
{
"medien_id": "med_0f5e7a5e4f72fafb60daa1da",
"dateiname": "wohnzimmer.jpg",
"typ": "image/jpeg",
"groesse": 84055,
"breite": 1200,
"hoehe": 630,
"verfaellt_ungenutzt": "2026-10-03T01:02:41+02:00"
} miete.json
{
"status": "entwurf",
"objektkategorie": {
"nutzungsart": [
"WOHNEN"
],
"vermarktungsart": [
"MIETE_PACHT"
],
"objektart": {
"typ": "wohnung",
"untertyp": "DACHGESCHOSS"
}
},
"geo": {
"plz": "40213",
"ort": "Düsseldorf",
"land": "DEU"
},
"preise": {
"kaltmiete": 1180,
"nebenkosten": 240,
"kaution": 3540,
"provisionspflichtig": false
},
"flaechen": {
"wohnflaeche": 71.4,
"anzahl_zimmer": 2.5
},
"freitexte": {
"objekttitel": "Dachgeschoss mit Blick über die Altstadt"
},
"anhaenge": [
{
"gruppe": "TITELBILD",
"medien_id": "med_0f5e7a5e4f72fafb60daa1da"
}
],
"verwaltung_objekt": {
"haustiere": true,
"verfuegbar_ab": "ab 1. November"
}
}curl -X PUT "https://api.immoriver.com/v1/objekte/DOKU-4712?warten=20" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data @miete.jsonAntwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
Content-Location: /v1/lieferungen/65572137
RateLimit-Limit: 60
RateLimit-Remaining: 56
RateLimit-Reset: 19
{
"lieferung": "65572137",
"status": "erfolgreich",
"kanal": "api",
"erstellt": "2026-09-26T01:02:41+02:00",
"beendet": "2026-09-26T01:02:41+02:00",
"objekte_gesamt": 1,
"medien": 1,
"fehler": null,
"objekte": [
{
"obid": "DOKU-4712",
"objektnr_extern": "DOKU-4712",
"expose_nr": 112174,
"ergebnis": "neu",
"status": "entwurf",
"freigabe": "entwurf",
"fehlend": [],
"meldung": null,
"url": null
}
],
"hinweise": [],
"testmodus": false
}Status und Veröffentlichung
Mit "status": "aktiv" (Standard) geht ein Objekt online, sobald alles stimmt; mit "status": "entwurf" bleibt es offline. Später ändern Sie den Status mit POST /v1/objekte/{obid}/status: aktiv, entwurf, pausiert, verkauft, vermietet oder archiviert.
Was „aktiv“ voraussetzt
- Titel, Ort, Preis (oder kaufpreis_auf_anfrage), eine Fläche, bei Wohnobjekten die Zimmerzahl, mindestens ein Bild.
- In Deutschland die Angaben nach § 87 GModG, sofern ein Energieausweis nötig ist: Baujahr, Art des Ausweises, Kennwert, wesentlicher Energieträger. Nicht nötig bei Grundstücken, Denkmälern (verwaltung_objekt.denkmalgeschuetzt) und unter 50 m². Österreich (§ 3 EAVG): HWB, dazu fGEE oder – bei Ausweisen nach neuem Recht – Endenergiebedarf mit Klasse (energieeffizienzklasse).
- Platz im Paket: Aktiv sein dürfen höchstens so viele Objekte gleichzeitig, wie Ihr Paket erlaubt. Ist es voll, weist die API ein weiteres aktives Objekt mit 409 kontingent_erschoepft ab und speichert nichts. Als Entwurf geht es immer.
Fehlen Angaben, wird das Objekt trotzdem gespeichert und bleibt Entwurf; die Lieferung nennt in fehlend, was fehlt. Ein Statuswechsel auf „aktiv“ ohne diese Angaben kommt mit 409 zurück:
curl -X POST "https://api.immoriver.com/v1/objekte/DOKU-4712/status" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data '{"status":"aktiv"}'Antwort
HTTP 409
Content-Type: application/problem+json; charset=UTF-8
RateLimit-Limit: 60
RateLimit-Remaining: 55
RateLimit-Reset: 18
{
"type": "https://immoriver.com/entwickler#fehler-pflichtangaben_fehlen",
"title": "Pflichtangaben fehlen",
"status": 409,
"code": "pflichtangaben_fehlen",
"detail": "Das Objekt kann so nicht online gehen, siehe fehlend.",
"anfrage_id": "00MUHKGDY27D3B9AC0D020E5E0",
"fehlend": [
"Baujahr",
"Art des Energieausweises",
"Energiekennwert",
"Wesentlicher Energieträger"
]
} curl -X POST "https://api.immoriver.com/v1/objekte/DOKU-4711/status" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Idempotency-Key: 6f1c2d9e-pause-4711" \
-H "Content-Type: application/json" \
--data '{"status":26003}'Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 60
RateLimit-Remaining: 54
RateLimit-Reset: 18
{
"obid": "DOKU-4711",
"status": {
"id": 26003,
"code": "pausiert",
"text": "Pausiert"
},
"vorher": {
"id": 26002,
"code": "aktiv",
"text": "Aktiv"
},
"url": null
}Idempotency-Key: Bei POST können Sie eine eigene Kennung mitsenden. Kommt dieselbe Anfrage binnen 24 Stunden noch einmal (etwa nach einem Netzfehler), liefern wir die erste Antwort erneut aus (Kopfzeile Idempotent-Replayed: true) statt sie ein zweites Mal auszuführen. PUT und DELETE sind von sich aus wiederholbar.
Lieferungen und Ergebnisse
Jede Lieferung hat eine Nummer. GET /v1/lieferungen/{nummer} zeigt ihren Stand, GET /v1/lieferungen die letzten, auch die über FTP.
| Feld | Werte |
|---|---|
status | wartet, laeuft, erfolgreich, teilweise, fehler, abgelehnt |
objekte[].ergebnis | neu, aktualisiert, unveraendert, geloescht, uebersprungen, fehler |
objekte[].freigabe | aktiv, entwurf, pflichtangaben_fehlen, kontingent_erschoepft, kein_paket, laufzeit_abgelaufen, als_verkauft_gemeldet |
objekte[].fehlend | Was für die Veröffentlichung fehlt, in Klartext |
curl -X GET "https://api.immoriver.com/v1/lieferungen/65799886" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 18
{
"lieferung": "65799886",
"status": "erfolgreich",
"kanal": "api",
"erstellt": "2026-09-26T01:02:38+02:00",
"beendet": "2026-09-26T01:02:40+02:00",
"objekte_gesamt": 1,
"medien": 1,
"fehler": null,
"objekte": [
{
"obid": "DOKU-4711",
"objektnr_extern": "W-4711",
"expose_nr": 112173,
"ergebnis": "neu",
"status": "aktiv",
"freigabe": "aktiv",
"fehlend": [],
"meldung": null,
"url": "https://immoriver.com/expose/112173"
}
]
}Objekte abrufen
GET /v1/objekte listet die Objekte Ihrer Firma (auch per FTP oder im Portal angelegte), 50 je Seite, bis 200 mit ?anzahl=. Weiter blättern Sie mit ?nach= und dem Wert aus weiter. Filter: status und geaendert_seit (ISO 8601).
GET /v1/objekte/{obid} zeigt den Stand im Portal (Exposénummer, Adresse, Status, fehlende Pflichtangaben, Anfragen) und unter daten dasselbe JSON, das PUT annimmt. Im Portal von Hand angelegte Objekte haben keine obid und lassen sich über die API nicht ändern.
curl -X GET "https://api.immoriver.com/v1/objekte/DOKU-4711" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 120
RateLimit-Remaining: 118
RateLimit-Reset: 19
{
"obid": "DOKU-4711",
"objektnr_extern": "W-4711",
"expose_nr": 112173,
"url": "https://immoriver.com/expose/112173",
"status": {
"id": 26002,
"code": "aktiv",
"text": "Aktiv"
},
"sichtbarkeit": {
"id": 27001,
"code": "public",
"text": "Öffentlich"
},
"kanal": "api",
"titel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer",
"vermarktungsart": {
"id": 25001,
"code": "KAUF",
"text": "Kauf"
},
"objektart": {
"id": 10001,
"code": "wohnung",
"text": "Wohnung"
},
"plz": "50667",
"ort": "Köln",
"preis": 489000,
"preis_auf_anfrage": false,
"waehrung": "EUR",
"bilder": 1,
"anfragen": 0,
"erstellt": "2026-09-26T01:02:39+02:00",
"geaendert": "2026-09-26T01:02:39+02:00",
"veroeffentlicht_am": "2026-09-26T01:02:39+02:00",
"laeuft_ab_am": null,
"fehlende_pflichtangaben": [],
"daten": {
"objektkategorie": {
"nutzungsart": [
{
"id": 24001,
"code": "WOHNEN",
"text": "Wohnen"
}
],
"vermarktungsart": [
{
"id": 25001,
"code": "KAUF",
"text": "Kauf"
}
],
"objektart": {
"typ": {
"id": 10001,
"code": "wohnung",
"text": "Wohnung"
},
"untertyp": {
"id": 12006,
"code": "ETAGE",
"text": "Etagenwohnung"
}
}
},
"geo": {
"plz": "50667",
"ort": "Köln",
"strasse": "Domkloster",
"hausnummer": "4",
"land": "DEU",
"regionaler_zusatz": "Altstadt-Nord",
"etage": 2,
"anzahl_etagen": 5
},
"kontaktperson": {
"anrede": "Frau",
"vorname": "Anna",
"name": "Berger",
"email_zentrale": "info@beispiel-immobilien.de",
"tel_durchw": "+49 221 123456-12"
},
"preise": {
"kaufpreis": 489000,
"hausgeld": 310,
"waehrung": "EUR",
"provisionspflichtig": true,
"aussen_courtage": "3,57 %",
"aussen_courtage_mit_mwst": true,
"stellplaetze": [
{
"art": "TIEFGARAGE",
"anzahl": 1,
"kaufpreis": 25000
}
]
},
"flaechen": {
"wohnflaeche": 92.5,
"anzahl_zimmer": 3,
"anzahl_schlafzimmer": 2,
"anzahl_badezimmer": 1,
"anzahl_balkone": 1
},
"ausstattung": {
"ausstatt_kategorie": {
"id": 52002,
"code": "GEHOBEN",
"text": "Gehoben"
},
"heizungsart": [
{
"id": 32003,
"code": "ZENTRAL",
"text": "Zentralheizung"
},
{
"id": 32005,
"code": "FUSSBODEN",
"text": "Fußbodenheizung"
}
],
"befeuerung": [
{
"id": 33002,
"code": "GAS",
"text": "Erdgas"
}
],
"kueche": [
{
"id": 41001,
"code": "EBK",
"text": "Einbauküche"
}
],
"boden": [
{
"id": 42004,
"code": "PARKETT",
"text": "Parkett"
},
{
"id": 42001,
"code": "FLIESEN",
"text": "Fliesen"
}
],
"fahrstuhl": [
{
"id": 44001,
"code": "PERSONEN",
"text": "Personenaufzug"
}
],
"ausricht_balkon_terrasse": [
{
"id": 45008,
"code": "SUEDWEST",
"text": "Südwest"
}
],
"unterkellert": {
"id": 50001,
"code": "JA",
"text": "Unterkellert"
},
"gaestewc": true
},
"zustand_angaben": {
"baujahr": 1998,
"zustand": {
"id": 29012,
"code": "GEPFLEGT",
"text": "Gepflegt"
},
"energiepass": {
"epart": {
"id": 35002,
"code": "VERBRAUCH",
"text": "Verbrauchsausweis"
},
"jahrgang": {
"id": 36002,
"code": "2014",
"text": "Fassung 2014"
},
"gebaeudeart": {
"id": 37001,
"code": "wohn",
"text": "Wohngebäude"
},
"gueltig_bis": "2031-05-01",
"energieverbrauchkennwert": 98.4,
"primaerenergietraeger": {
"id": 34001,
"code": "GAS",
"text": "Erdgas"
},
"wertklasse": "C",
"mitwarmwasser": true
}
},
"freitexte": {
"objekttitel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer",
"objektbeschreibung": "Die Wohnung liegt im zweiten Obergeschoss eines gepflegten Hauses von 1998.\n\nWohnzimmer und Küche öffnen sich zum Südwestbalkon.",
"lage": "Dom, Rheinufer und Hauptbahnhof erreichen Sie zu Fuß."
},
"anhaenge": [
{
"gruppe": "TITELBILD",
"titel": "Ansicht",
"url": "https://immoriver.com/assets/bilder/teilen.jpg"
}
],
"verwaltung_objekt": {
"objektadresse_freigeben": false,
"verfuegbar_ab": "nach Vereinbarung"
},
"verwaltung_techn": {
"objektnr_extern": "W-4711"
}
}
}curl -X GET "https://api.immoriver.com/v1/objekte?status=aktiv&anzahl=1&geaendert_seit=2026-09-26T01%3A02%3A38%2B02%3A00" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 120
RateLimit-Remaining: 117
RateLimit-Reset: 19
{
"objekte": [
{
"obid": "DOKU-4711",
"objektnr_extern": "W-4711",
"expose_nr": 112173,
"url": "https://immoriver.com/expose/112173",
"status": {
"id": 26002,
"code": "aktiv",
"text": "Aktiv"
},
"sichtbarkeit": {
"id": 27001,
"code": "public",
"text": "Öffentlich"
},
"kanal": "api",
"titel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer",
"vermarktungsart": {
"id": 25001,
"code": "KAUF",
"text": "Kauf"
},
"objektart": {
"id": 10001,
"code": "wohnung",
"text": "Wohnung"
},
"plz": "50667",
"ort": "Köln",
"preis": 489000,
"preis_auf_anfrage": false,
"waehrung": "EUR",
"bilder": 1,
"anfragen": 0,
"erstellt": "2026-09-26T01:02:39+02:00",
"geaendert": "2026-09-26T01:02:39+02:00",
"veroeffentlicht_am": "2026-09-26T01:02:39+02:00",
"laeuft_ab_am": null
}
],
"weiter": null
}Anfragen abholen
GET /v1/anfragen liefert Anfragen in der Reihenfolge ihrer letzten Änderung, dazu einen Cursor weiter. Speichern Sie ihn und geben Sie ihn beim nächsten Abruf als ?nach= mit: Dann kommt nur, was seitdem neu ist oder sich geändert hat. Alle fünf Minuten abzufragen genügt.
curl -X GET "https://api.immoriver.com/v1/anfragen?nach=MjAyNi0wOS0yNiAwMTowMjozN3ww" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 120
RateLimit-Remaining: 115
RateLimit-Reset: 18
{
"anfragen": [
{
"anfragenummer": 4013130,
"erstellt": "2026-09-26T01:02:42+02:00",
"geaendert": "2026-09-26T01:02:42+02:00",
"status": {
"id": 84001,
"code": "new",
"text": "Neu"
},
"abschlussgrund": null,
"anonymisiert": false,
"objekt": {
"obid": "DOKU-4711",
"expose_nr": 112173,
"objektnr_extern": "W-4711",
"titel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer"
},
"projekt": null,
"interessent": {
"anrede": {
"id": 65002,
"code": "herr",
"text": "Herr"
},
"vorname": "Jonas",
"nachname": "Weber",
"firma": null,
"email": "doku@immoriver.invalid",
"telefon": "+49 170 1234567",
"strasse": null,
"plz": "50823",
"ort": "Köln",
"land": "DE"
},
"nachricht": "Guten Tag, ist die Wohnung noch frei? Ich würde sie gern am Samstag besichtigen.",
"wuensche": {
"rueckruf": false,
"besichtigung": true,
"finanzierung": true,
"unterlagen": false
},
"mietangaben": null,
"einwilligung": {
"am": "2026-09-26T01:02:42+02:00",
"fassung": "2026-08"
}
}
],
"weiter": "MjAyNi0wOS0yNiAwMTowMjo0Mnw1Nw",
"mehr": false
} GET /v1/anfragen/{anfragenummer} zeigt zusätzlich den Nachrichtenverlauf. Den Bearbeitungsstand melden Sie mit POST /v1/anfragen/{anfragenummer}/status: opened, contacted, qualified, appointment oder closed (mit abschlussgrund vergeben, zurueckgezogen, vom_markt oder erledigt). Das hält Ihre Antwortquote im Portal richtig und beendet die Erinnerungsmails.
curl -X POST "https://api.immoriver.com/v1/anfragen/4013130/status" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/json" \
--data '{"status":"contacted"}'Antwort anzeigen (HTTP 200)
HTTP 200
Content-Type: application/json; charset=UTF-8
RateLimit-Limit: 60
RateLimit-Remaining: 52
RateLimit-Reset: 17
{
"anfragenummer": 4013130,
"erstellt": "2026-09-26T01:02:42+02:00",
"geaendert": "2026-09-26T01:02:43+02:00",
"status": {
"id": 84003,
"code": "contacted",
"text": "Kontaktiert"
},
"abschlussgrund": null,
"anonymisiert": false,
"objekt": {
"obid": "DOKU-4711",
"expose_nr": 112173,
"objektnr_extern": "W-4711",
"titel": "Helle 3-Zimmer-Wohnung mit Balkon nahe Rheinufer"
},
"projekt": null,
"interessent": {
"anrede": {
"id": 65002,
"code": "herr",
"text": "Herr"
},
"vorname": "Jonas",
"nachname": "Weber",
"firma": null,
"email": "doku@immoriver.invalid",
"telefon": "+49 170 1234567",
"strasse": null,
"plz": "50823",
"ort": "Köln",
"land": "DE"
},
"nachricht": "Guten Tag, ist die Wohnung noch frei? Ich würde sie gern am Samstag besichtigen.",
"wuensche": {
"rueckruf": false,
"besichtigung": true,
"finanzierung": true,
"unterlagen": false
},
"mietangaben": null,
"einwilligung": {
"am": "2026-09-26T01:02:42+02:00",
"fassung": "2026-08"
}
}Datenschutz
Sie erhalten, was die Anfrage ohnehin an Sie übermittelt: Name, Kontaktdaten, Nachricht, Wünsche und, bei Mietanfragen, die freiwilligen Angaben zum Haushalt. Die Einwilligung des Interessenten (Zeitpunkt, Fassung) steht dabei. Lässt ein Interessent seine Daten löschen, erscheint die Anfrage erneut im Änderungsstrom, mit anonymisiert: true und ohne Personendaten. Bitte löschen Sie die Daten dann auch bei sich (Art. 17 und 19 DSGVO). Jeder Abruf wird protokolliert.
Werte und IDs
Jedes Feld mit fester Auswahl (Objektart, Heizung, Zustand, Status …) hat zu jedem Wert eine dauerhafte ID. Die ID ändert sich nie, auch wenn sich ein Text oder ein OpenImmo-Code ändert; sie ist die sichere Wahl für Ihre Software. Die IDs stehen in der Feldreferenz unten und maschinenlesbar in GET /v1/feldkatalog (wertetabelle).
Antworten liefern jeden Wert als Objekt mit ID, Code und Text in der Sprache Ihrer Anfrage (Accept-Language: de oder en):
"objektart": { "id": 10001, "code": "wohnung", "text": "Wohnung" },
"heizungsart": [
{ "id": 32003, "code": "ZENTRAL", "text": "Zentralheizung" },
{ "id": 32005, "code": "FUSSBODEN", "text": "Fußbodenheizung" }
]
In Anfragen (PUT, POST) nehmen wir jede der drei Formen an — den Code wie bisher, die ID oder das Objekt aus einer Antwort (id hat Vorrang vor code). Eine GET-Antwort lässt sich so unverändert wieder senden.
"heizungsart": ["ZENTRAL", "FUSSBODEN"]
"heizungsart": [32003, 32005]
"heizungsart": [{ "id": 32003 }, { "code": "FUSSBODEN" }]
Keine Werteliste in diesem Sinn und deshalb reine Codes: Land (ISO 3166-1 alpha-3), Währung (ISO 4217) und Energieeffizienzklasse.
Währungen: EUR, USD, GBP, CHF, AED und GEL — über die API wie per OpenImmo-Lieferung (preise/waehrung@iso_waehrung). Fehlt die Angabe, gilt die Landeswährung des Objekts (CHF in der Schweiz, GBP in Großbritannien, AED in den Emiraten, GEL in Georgien, sonst EUR). Die API weist andere Codes ab; eine Lieferung per FTP übernimmt sie nicht und setzt die Landeswährung. Suche und Preisfilter rechnen tagesaktuell in Euro um.
Feldreferenz
Alle 298 Felder. Pflicht „immer“ heißt: ohne das Feld 422. „aktiv“ heißt: nötig, damit das Objekt online gehen kann. Die Liste gibt es maschinenlesbar unter GET /v1/feldkatalog.
Objektkategorie
| Feld | Typ | Beschreibung |
|---|---|---|
objektkategorie.nutzungsart
immer
|
mehrfach | Nutzungsart, mehrere möglich Werte (ID Code): 24001 WOHNEN, 24002 GEWERBE, 24003 ANLAGE, 24004 WAZ OpenImmo: objektkategorie/nutzungsart@* |
objektkategorie.vermarktungsart
immer
|
mehrfach | Vermarktungsart. KAUF oder MIETE_PACHT ist Pflicht, ERBPACHT und LEASING kommen dazu Werte (ID Code): 25001 KAUF, 25002 MIETE_PACHT, 25003 ERBPACHT, 25004 LEASING OpenImmo: objektkategorie/vermarktungsart@* |
objektkategorie.objektart.typ
immer
|
auswahl | Objektart (Element unter <objektart>) Werte (ID Code): 10001 wohnung, 10002 haus, 10003 grundstueck, 10004 zimmer, 10005 buero_praxen, 10006 einzelhandel, 10007 gastgewerbe, 10008 hallen_lager_prod, 10009 land_und_forstwirtschaft, 10010 parken, 10011 sonstige, 10012 freizeitimmobilie_gewerblich, 10013 zinshaus_renditeobjekt OpenImmo: objektkategorie/objektart/* |
objektkategorie.objektart.untertyp
|
auswahl | Untertyp, abhängig von der Objektart (z. B. wohnungtyp, haustyp). Erlaubte Werte: /v1/wertelisten Werte je Objektart OpenImmo: objektkategorie/objektart/*@*_typ |
Lage und Adresse
| Feld | Typ | Beschreibung |
|---|---|---|
geo.plz
immer
|
text bis 12 Zeichen |
Postleitzahl OpenImmo: geo/plz |
geo.ort
immer
|
text bis 120 Zeichen |
Ort OpenImmo: geo/ort |
geo.strasse
|
text bis 150 Zeichen |
Straße OpenImmo: geo/strasse |
geo.hausnummer
|
text bis 20 Zeichen |
Hausnummer OpenImmo: geo/hausnummer |
geo.land
|
auswahl | Land (ISO 3166-1 alpha-3, alpha-2 wird umgesetzt) Werte: DEU, AUT, CHE, ESP, CYP, GEO, FRA OpenImmo: geo/land@iso_land |
geo.bundesland
|
text bis 80 Zeichen |
Bundesland OpenImmo: geo/bundesland |
geo.regionaler_zusatz
|
text bis 120 Zeichen |
Ortsteil oder Stadtteil OpenImmo: geo/regionaler_zusatz |
geo.lage_gebiet
|
text bis 191 Zeichen |
Lagebezeichnung (Gebiet, Siedlung) OpenImmo: geo/lage_gebiet |
geo.breitengrad
|
zahl -90 … 90, 7 Nachkommastellen |
Breitengrad (WGS 84). Ohne Angabe ermitteln wir ihn aus der Adresse OpenImmo: geo/geokoordinaten@breitengrad |
geo.laengengrad
|
zahl -180 … 180, 7 Nachkommastellen |
Längengrad (WGS 84) OpenImmo: geo/geokoordinaten@laengengrad |
geo.etage
|
ganzzahl -5 … 200 |
Etage (0 = Erdgeschoss, negativ = Untergeschoss) OpenImmo: geo/etage |
geo.anzahl_etagen
|
ganzzahl 0 … 200 |
Anzahl der Etagen im Gebäude OpenImmo: geo/anzahl_etagen |
geo.wohnungsnr
|
text bis 40 Zeichen |
Wohnungsnummer OpenImmo: geo/wohnungsnr |
geo.flur
|
text bis 60 Zeichen |
Flur (Kataster) OpenImmo: geo/flur |
geo.flurstueck
|
text bis 60 Zeichen |
Flurstück OpenImmo: geo/flurstueck |
geo.gemarkung
|
text bis 120 Zeichen |
Gemarkung OpenImmo: geo/gemarkung |
geo.gemeindecode
|
text bis 20 Zeichen |
Amtlicher Gemeindeschlüssel OpenImmo: geo/gemeindecode |
geo.lage_gebiet_gebiete
|
auswahl | Lage im Gebiet Werte (ID Code): 90001 WOHN, 90002 GEWERBE, 90003 INDUSTRIE, 90004 MISCH, 90005 NEUBAU, 90006 ORTSLAGE, 90007 SIEDLUNG, 90008 STADTRAND, 90009 STADTTEIL, 90010 STADTZENTRUM, 90011 NEBENZENTRUM, 90012 1A, 90013 1B OpenImmo: geo/lage_gebiet@gebiete |
geo.lage_im_bau
|
mehrfach | Lage im Gebäude Werte (ID Code): 97001 LINKS, 97002 RECHTS, 97003 VORNE, 97004 HINTEN OpenImmo: geo/lage_im_bau@* |
Ansprechpartner
| Feld | Typ | Beschreibung |
|---|---|---|
kontaktperson.anrede
|
text bis 40 Zeichen |
Anrede OpenImmo: kontaktperson/anrede |
kontaktperson.vorname
|
text bis 100 Zeichen |
Vorname OpenImmo: kontaktperson/vorname |
kontaktperson.name
|
text bis 100 Zeichen |
Nachname OpenImmo: kontaktperson/name |
kontaktperson.firma
|
text bis 191 Zeichen |
Firma OpenImmo: kontaktperson/firma |
kontaktperson.email_direkt
|
text bis 191 Zeichen |
Persönliche E-Mail der betreuenden Person. Anfragen zu diesem Objekt gehen dorthin. Gibt es dazu noch kein Konto, legen wir ein vorgemerktes Teammitglied Ihrer Firma an, das Sie unter /konto/team bestätigen oder ablehnen OpenImmo: kontaktperson/email_direkt |
kontaktperson.email_zentrale
|
text bis 191 Zeichen |
Zentrale E-Mail des Büros. Ohne email_direkt gilt sie als Adresse der betreuenden Person (mit denselben Folgen). Ohne beide gehen Anfragen an die Adresse Ihrer Firma OpenImmo: kontaktperson/email_zentrale |
kontaktperson.tel_durchw
|
text bis 60 Zeichen |
Telefon (Durchwahl) OpenImmo: kontaktperson/tel_durchw |
kontaktperson.tel_zentrale
|
text bis 60 Zeichen |
Telefon (Zentrale) OpenImmo: kontaktperson/tel_zentrale |
kontaktperson.tel_handy
|
text bis 60 Zeichen |
Mobiltelefon OpenImmo: kontaktperson/tel_handy |
kontaktperson.strasse
|
text bis 150 Zeichen |
Straße des Büros OpenImmo: kontaktperson/strasse |
kontaktperson.plz
|
text bis 12 Zeichen |
PLZ des Büros OpenImmo: kontaktperson/plz |
kontaktperson.ort
|
text bis 120 Zeichen |
Ort des Büros OpenImmo: kontaktperson/ort |
kontaktperson.url
|
text bis 255 Zeichen |
Webseite OpenImmo: kontaktperson/url |
kontaktperson.personennummer
|
text bis 100 Zeichen |
Ihre interne Kennung der Person (hilft bei gemeinsamen Büroadressen) OpenImmo: kontaktperson/personennummer |
Preise und Provision
| Feld | Typ | Beschreibung |
|---|---|---|
preise.kaufpreis
aktiv
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Kaufpreis OpenImmo: preise/kaufpreis |
preise.kaufpreis_auf_anfrage
|
bool | Preis auf Anfrage. Ersetzt den Kaufpreis für die Veröffentlichung OpenImmo: preise/kaufpreis@auf_anfrage |
preise.kaufpreisnetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Kaufpreis netto OpenImmo: preise/kaufpreisnetto |
preise.kaufpreis_pro_qm
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Kaufpreis je m² OpenImmo: preise/kaufpreis_pro_qm |
preise.kaltmiete
aktiv
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Kaltmiete monatlich OpenImmo: preise/kaltmiete |
preise.warmmiete
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Warmmiete monatlich OpenImmo: preise/warmmiete |
preise.nettokaltmiete
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Nettokaltmiete OpenImmo: preise/nettokaltmiete |
preise.nebenkosten
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Nebenkosten monatlich OpenImmo: preise/nebenkosten |
preise.heizkosten
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Heizkosten monatlich OpenImmo: preise/heizkosten |
preise.heizkosten_enthalten
|
bool | Heizkosten in den Nebenkosten enthalten OpenImmo: preise/heizkosten_enthalten |
preise.mietpreis_pro_qm
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Miete je m² OpenImmo: preise/mietpreis_pro_qm |
preise.pauschalmiete
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Pauschalmiete OpenImmo: preise/pauschalmiete |
preise.mietzuschlaege
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Mietzuschläge OpenImmo: preise/mietzuschlaege |
preise.hausgeld
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Hausgeld monatlich OpenImmo: preise/hausgeld |
preise.kaution
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Kaution OpenImmo: preise/kaution |
preise.kaution_text
|
text bis 255 Zeichen |
Kaution als Text (z. B. „3 Nettokaltmieten“) OpenImmo: preise/kaution_text |
preise.pacht
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Pacht OpenImmo: preise/pacht |
preise.erbpacht
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Erbbauzins jährlich OpenImmo: preise/erbpacht |
preise.erschliessungskosten
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Erschließungskosten OpenImmo: preise/erschliessungskosten |
preise.waehrung
|
auswahl | Währung (ohne Angabe: Landeswährung — CHF in CH, GBP in GB, AED in AE, GEL in GE, sonst EUR) Werte: EUR, USD, GBP, CHF, AED, GEL OpenImmo: preise/waehrung@iso_waehrung |
preise.preis_zeiteinheit
|
auswahl | Zeiteinheit des Preises (bei Kurzzeitmiete) Werte (ID Code): 58001 TAG, 58002 WOCHE, 58003 MONAT, 58004 JAHR OpenImmo: preise/preis_zeiteinheit@zeiteinheit |
preise.provisionspflichtig
immer
|
bool | Fällt für den Käufer oder Mieter eine Provision an? Pflicht, weil „provisionsfrei“ sonst nicht zu unterscheiden ist OpenImmo: preise/provisionspflichtig |
preise.aussen_courtage
|
text bis 120 Zeichen |
Käuferprovision (Außenprovision) OpenImmo: preise/aussen_courtage |
preise.aussen_courtage_mit_mwst
|
bool | Käuferprovision inklusive MwSt. OpenImmo: preise/aussen_courtage@mit_mwst |
preise.innen_courtage
|
text bis 120 Zeichen |
Verkäuferprovision (Innenprovision) OpenImmo: preise/innen_courtage |
preise.innen_courtage_mit_mwst
|
bool | Verkäuferprovision inklusive MwSt. OpenImmo: preise/innen_courtage@mit_mwst |
preise.courtage_hinweis
|
text bis 500 Zeichen |
Hinweis zur Provision OpenImmo: preise/courtage_hinweis |
preise.provision_teilen
|
text bis 120 Zeichen |
Provisionsteilung (Wert) OpenImmo: preise/provision_teilen |
preise.provision_teilen_wert
|
auswahl | Art der Provisionsteilung Werte (ID Code): 59001 absolut, 59002 prozent, 59003 text OpenImmo: preise/provision_teilen@wert |
preise.provisionbrutto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Provision brutto (Betrag) OpenImmo: preise/provisionbrutto |
preise.provisionnetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Provision netto (Betrag) OpenImmo: preise/provisionnetto |
preise.freitext_preis
|
text bis 2000 Zeichen |
Freitext zum Preis OpenImmo: preise/freitext_preis |
preise.mwst_satz
|
zahl 0 … 100, 2 Nachkommastellen |
Mehrwertsteuersatz in % OpenImmo: preise/mwst_satz |
preise.mwst_gesamt
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Mehrwertsteuer gesamt OpenImmo: preise/mwst_gesamt |
preise.zzg_mehrwertsteuer
|
bool | Zuzüglich Mehrwertsteuer (Gewerbe) OpenImmo: preise/zzg_mehrwertsteuer |
preise.richtpreis
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Richtpreis OpenImmo: preise/richtpreis |
preise.x_fache
|
zahl 0 … 999999.99, 2 Nachkommastellen |
Kaufpreisfaktor (Vielfaches der Jahresmiete) OpenImmo: preise/x_fache |
preise.nettorendite
|
zahl -100 … 9999.99, 2 Nachkommastellen |
Nettorendite in % OpenImmo: preise/nettorendite |
preise.nettorendite_soll
|
zahl -100 … 9999.99, 2 Nachkommastellen |
Nettorendite Soll in % OpenImmo: preise/nettorendite_soll |
preise.nettorendite_ist
|
zahl -100 … 9999.99, 2 Nachkommastellen |
Nettorendite Ist in % OpenImmo: preise/nettorendite_ist |
preise.mieteinnahmen_ist
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Mieteinnahmen Ist (jährlich) OpenImmo: preise/mieteinnahmen_ist |
preise.mieteinnahmen_soll
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Mieteinnahmen Soll (jährlich) OpenImmo: preise/mieteinnahmen_soll |
preise.stellplaetze
|
liste | Stellplätze zum Objekt: Liste aus {art, anzahl, kaufpreis, miete}. art: GARAGE, TIEFGARAGE, CARPORT, FREIPLATZ, DUPLEX, PARKHAUS OpenImmo: preise/stp_* |
preise.kaufpreisbrutto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Kaufpreis brutto OpenImmo: preise/kaufpreisbrutto |
preise.hauptmietzinsnetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Hauptmietzins netto OpenImmo: preise/hauptmietzinsnetto |
preise.hauptmietzinsnetto_hauptmietzinsust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Hauptmietzins OpenImmo: preise/hauptmietzinsnetto@hauptmietzinsust |
preise.betriebskostennetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Betriebskosten netto OpenImmo: preise/betriebskostennetto |
preise.betriebskostennetto_betriebskostenust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Betriebskosten OpenImmo: preise/betriebskostennetto@betriebskostenust |
preise.evbnetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Erhaltungs- und Verbesserungsbeitrag netto OpenImmo: preise/evbnetto |
preise.evbnetto_evbust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer EVB OpenImmo: preise/evbnetto@evbust |
preise.gesamtmietenetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtmiete netto OpenImmo: preise/gesamtmietenetto |
preise.gesamtmietenetto_gesamtmieteust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Gesamtmiete OpenImmo: preise/gesamtmietenetto@gesamtmieteust |
preise.gesamtmietebrutto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtmiete brutto OpenImmo: preise/gesamtmietebrutto |
preise.gesamtbelastungnetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtbelastung netto OpenImmo: preise/gesamtbelastungnetto |
preise.gesamtbelastungnetto_gesamtbelastungust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Gesamtbelastung OpenImmo: preise/gesamtbelastungnetto@gesamtbelastungust |
preise.gesamtbelastungbrutto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtbelastung brutto OpenImmo: preise/gesamtbelastungbrutto |
preise.gesamtkostenprom2von
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtkosten je m² ab OpenImmo: preise/gesamtkostenprom2von |
preise.gesamtkostenprom2von_gesamtkostenprom2bis
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Gesamtkosten je m² bis OpenImmo: preise/gesamtkostenprom2von@gesamtkostenprom2bis |
preise.heizkostennetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Heizkosten netto OpenImmo: preise/heizkostennetto |
preise.heizkostennetto_heizkostenust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Heizkosten OpenImmo: preise/heizkostennetto@heizkostenust |
preise.monatlichekostennetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Monatliche Kosten netto OpenImmo: preise/monatlichekostennetto |
preise.monatlichekostennetto_monatlichekostenust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer monatliche Kosten OpenImmo: preise/monatlichekostennetto@monatlichekostenust |
preise.monatlichekostenbrutto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Monatliche Kosten brutto OpenImmo: preise/monatlichekostenbrutto |
preise.nebenkostenprom2von
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Nebenkosten je m² ab OpenImmo: preise/nebenkostenprom2von |
preise.nebenkostenprom2von_nebenkostenprom2bis
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Nebenkosten je m² bis OpenImmo: preise/nebenkostenprom2von@nebenkostenprom2bis |
preise.ruecklagenetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Instandhaltungsrücklage netto OpenImmo: preise/ruecklagenetto |
preise.ruecklagenetto_ruecklageust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Rücklage OpenImmo: preise/ruecklagenetto@ruecklageust |
preise.sonstigekostennetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Sonstige Kosten netto OpenImmo: preise/sonstigekostennetto |
preise.sonstigekostennetto_sonstigekostenust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer sonstige Kosten OpenImmo: preise/sonstigekostennetto@sonstigekostenust |
preise.sonstigemietenetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Sonstige Miete netto OpenImmo: preise/sonstigemietenetto |
preise.sonstigemietenetto_sonstigemieteust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer sonstige Miete OpenImmo: preise/sonstigemietenetto@sonstigemieteust |
preise.summemietenetto
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Summe Miete netto OpenImmo: preise/summemietenetto |
preise.summemietenetto_summemieteust
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Umsatzsteuer Summe Miete OpenImmo: preise/summemietenetto@summemieteust |
preise.nettomieteprom2von
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Nettomiete je m² ab OpenImmo: preise/nettomieteprom2von |
preise.nettomieteprom2von_nettomieteprom2bis
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Nettomiete je m² bis OpenImmo: preise/nettomieteprom2von@nettomieteprom2bis |
preise.abstand
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Abstand/Ablöse OpenImmo: preise/abstand |
preise.preis_zeitraum_von
|
datum | Preis gilt ab OpenImmo: preise/preis_zeitraum_von |
preise.preis_zeitraum_bis
|
datum | Preis gilt bis OpenImmo: preise/preis_zeitraum_bis |
preise.geschaeftsguthaben
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Geschäftsguthaben OpenImmo: preise/geschaeftsguthaben |
preise.richtpreisprom2
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Richtpreis je m² OpenImmo: preise/richtpreisprom2 |
preise.mieteinnahmen_ist_periode
|
auswahl | Zeitraum der Mieteinnahmen Ist Werte (ID Code): 58001 TAG, 58002 WOCHE, 58003 MONAT, 58004 JAHR OpenImmo: preise/mieteinnahmen_ist@periode |
preise.mieteinnahmen_soll_periode
|
auswahl | Zeitraum der Mieteinnahmen Soll Werte (ID Code): 58001 TAG, 58002 WOCHE, 58003 MONAT, 58004 JAHR OpenImmo: preise/mieteinnahmen_soll@periode |
Bieterverfahren
| Feld | Typ | Beschreibung |
|---|---|---|
bieterverfahren.beginn_angebotsphase
|
datum | Beginn der Angebotsphase OpenImmo: bieterverfahren/beginn_angebotsphase |
bieterverfahren.besichtigungstermin
|
datum | Besichtigungstermin OpenImmo: bieterverfahren/besichtigungstermin |
bieterverfahren.besichtigungstermin_2
|
datum | Zweiter Besichtigungstermin OpenImmo: bieterverfahren/besichtigungstermin_2 |
bieterverfahren.beginn_bietzeit
|
zeitpunkt | Beginn der Bietzeit (ISO 8601 mit Uhrzeit) OpenImmo: bieterverfahren/beginn_bietzeit |
bieterverfahren.ende_bietzeit
|
datum | Ende der Bietzeit OpenImmo: bieterverfahren/ende_bietzeit |
bieterverfahren.mindestpreis
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Mindestpreis OpenImmo: bieterverfahren/mindestpreis |
bieterverfahren.hoechstgebot_zeigen
|
bool | Höchstgebot sichtbar OpenImmo: bieterverfahren/hoechstgebot_zeigen |
Versteigerung
| Feld | Typ | Beschreibung |
|---|---|---|
versteigerung.zwangsversteigerung
|
bool | Zwangsversteigerung OpenImmo: versteigerung/zwangsversteigerung |
versteigerung.aktenzeichen
|
text bis 255 Zeichen |
Aktenzeichen OpenImmo: versteigerung/aktenzeichen |
versteigerung.amtsgericht
|
text bis 255 Zeichen |
Amtsgericht OpenImmo: versteigerung/amtsgericht |
versteigerung.zvtermin
|
zeitpunkt | Versteigerungstermin (ISO 8601 mit Uhrzeit) OpenImmo: versteigerung/zvtermin |
versteigerung.zusatztermin
|
zeitpunkt | Weiterer Termin (ISO 8601 mit Uhrzeit) OpenImmo: versteigerung/zusatztermin |
versteigerung.verkehrswert
|
zahl 0 … 999999999999.99, 2 Nachkommastellen |
Verkehrswert OpenImmo: versteigerung/verkehrswert |
Flächen und Räume
| Feld | Typ | Beschreibung |
|---|---|---|
flaechen.wohnflaeche
aktiv
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Wohnfläche in m² OpenImmo: flaechen/wohnflaeche |
flaechen.nutzflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Nutzfläche in m² OpenImmo: flaechen/nutzflaeche |
flaechen.gesamtflaeche
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Gesamtfläche in m² OpenImmo: flaechen/gesamtflaeche |
flaechen.grundstuecksflaeche
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Grundstücksfläche in m² OpenImmo: flaechen/grundstuecksflaeche |
flaechen.bueroflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Bürofläche in m² OpenImmo: flaechen/bueroflaeche |
flaechen.lagerflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Lagerfläche in m² OpenImmo: flaechen/lagerflaeche |
flaechen.verkaufsflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Verkaufsfläche in m² OpenImmo: flaechen/verkaufsflaeche |
flaechen.ladenflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Ladenfläche in m² OpenImmo: flaechen/ladenflaeche |
flaechen.gastroflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Gastronomiefläche in m² OpenImmo: flaechen/gastroflaeche |
flaechen.gartenflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Gartenfläche in m² OpenImmo: flaechen/gartenflaeche |
flaechen.kellerflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Kellerfläche in m² OpenImmo: flaechen/kellerflaeche |
flaechen.balkon_terrasse_flaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Balkon- und Terrassenfläche in m² OpenImmo: flaechen/balkon_terrasse_flaeche |
flaechen.dachbodenflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Dachbodenfläche in m² OpenImmo: flaechen/dachbodenflaeche |
flaechen.beheizbare_flaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Beheizbare Fläche in m² OpenImmo: flaechen/beheizbare_flaeche |
flaechen.freiflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Freifläche in m² OpenImmo: flaechen/freiflaeche |
flaechen.sonstflaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Sonstige Fläche in m² OpenImmo: flaechen/sonstflaeche |
flaechen.vermietbare_flaeche
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Vermietbare Fläche in m² OpenImmo: flaechen/vermietbare_flaeche |
flaechen.teilbar_ab
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Teilbar ab in m² OpenImmo: flaechen/teilbar_ab |
flaechen.bgf
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Bruttogrundfläche in m² OpenImmo: flaechen/bgf |
flaechen.kubatur
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Umbauter Raum in m³ OpenImmo: flaechen/kubatur |
flaechen.grz
|
zahl 0 … 999.999, 3 Nachkommastellen |
Grundflächenzahl (GRZ) OpenImmo: flaechen/grz |
flaechen.gfz
|
zahl 0 … 999.999, 3 Nachkommastellen |
Geschossflächenzahl (GFZ) OpenImmo: flaechen/gfz |
flaechen.anzahl_zimmer
aktiv
|
zahl 0 … 999.5, 1 Nachkommastellen |
Zimmer (halbe erlaubt) OpenImmo: flaechen/anzahl_zimmer |
flaechen.anzahl_schlafzimmer
|
zahl 0 … 999.5, 1 Nachkommastellen |
Schlafzimmer OpenImmo: flaechen/anzahl_schlafzimmer |
flaechen.anzahl_badezimmer
|
zahl 0 … 999.5, 1 Nachkommastellen |
Badezimmer OpenImmo: flaechen/anzahl_badezimmer |
flaechen.anzahl_sep_wc
|
ganzzahl 0 … 65535 |
Separate WCs OpenImmo: flaechen/anzahl_sep_wc |
flaechen.anzahl_balkone
|
ganzzahl 0 … 65535 |
Balkone (ab 1 gilt das Objekt als „mit Balkon“) OpenImmo: flaechen/anzahl_balkone |
flaechen.anzahl_terrassen
|
ganzzahl 0 … 65535 |
Terrassen (ab 1 gilt das Objekt als „mit Terrasse“) OpenImmo: flaechen/anzahl_terrassen |
flaechen.anzahl_logia
|
ganzzahl 0 … 65535 |
Loggien OpenImmo: flaechen/anzahl_logia |
flaechen.anzahl_wohn_schlafzimmer
|
ganzzahl 0 … 65535 |
Wohn-Schlafzimmer OpenImmo: flaechen/anzahl_wohn_schlafzimmer |
flaechen.anzahl_stellplaetze
|
ganzzahl 0 … 65535 |
Stellplätze OpenImmo: flaechen/anzahl_stellplaetze |
flaechen.anzahl_wohneinheiten
|
ganzzahl 0 … 65535 |
Wohneinheiten OpenImmo: flaechen/anzahl_wohneinheiten |
flaechen.anzahl_gewerbeeinheiten
|
ganzzahl 0 … 65535 |
Gewerbeeinheiten OpenImmo: flaechen/anzahl_gewerbeeinheiten |
flaechen.anzahl_betten
|
ganzzahl 0 … 65535 |
Betten OpenImmo: flaechen/anzahl_betten |
flaechen.einliegerwohnung
|
bool | Mit Einliegerwohnung OpenImmo: flaechen/einliegerwohnung |
flaechen.bueroteilflaeche
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Büroteilfläche in m² OpenImmo: flaechen/bueroteilflaeche |
flaechen.verwaltungsflaeche
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Verwaltungsfläche in m² OpenImmo: flaechen/verwaltungsflaeche |
flaechen.flaechevon
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Fläche ab in m² OpenImmo: flaechen/flaechevon |
flaechen.flaechebis
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Fläche bis in m² OpenImmo: flaechen/flaechebis |
flaechen.fensterfront
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Fensterfront in m OpenImmo: flaechen/fensterfront |
flaechen.fensterfront_qm
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Fensterfläche in m² OpenImmo: flaechen/fensterfront_qm |
flaechen.grundstuecksfront
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Grundstücksfront in m OpenImmo: flaechen/grundstuecksfront |
flaechen.plaetze_gastraum
|
ganzzahl 0 … 2147483647 |
Plätze im Gastraum OpenImmo: flaechen/plaetze_gastraum |
flaechen.anzahl_tagungsraeume
|
ganzzahl 0 … 2147483647 |
Tagungsräume OpenImmo: flaechen/anzahl_tagungsraeume |
flaechen.bmz
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Baumassenzahl (BMZ) OpenImmo: flaechen/bmz |
flaechen.ausnuetzungsziffer
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Ausnützungsziffer OpenImmo: flaechen/ausnuetzungsziffer |
Ausstattung
| Feld | Typ | Beschreibung |
|---|---|---|
ausstattung.ausstatt_kategorie
|
auswahl | Ausstattungsqualität Werte (ID Code): 52001 STANDARD, 52002 GEHOBEN, 52003 LUXUS OpenImmo: ausstattung/ausstatt_kategorie |
ausstattung.heizungsart
|
mehrfach | Heizungsart Werte (ID Code): 32001 OFEN, 32002 ETAGE, 32003 ZENTRAL, 32004 FERN, 32005 FUSSBODEN OpenImmo: ausstattung/heizungsart@* |
ausstattung.befeuerung
|
mehrfach | Befeuerung (womit geheizt werden kann) Werte (ID Code): 33001 OEL, 33002 GAS, 33003 ELEKTRO, 33004 ALTERNATIV, 33005 SOLAR, 33006 ERDWAERME, 33007 LUFTWP, 33008 FERN, 33009 BLOCK, 33010 WASSER-ELEKTRO, 33011 PELLET, 33012 KOHLE, 33013 HOLZ, 33014 FLUESSIGGAS OpenImmo: ausstattung/befeuerung@* |
ausstattung.bad
|
mehrfach | Bad Werte (ID Code): 40001 DUSCHE, 40002 WANNE, 40003 FENSTER, 40004 BIDET, 40005 PISSOIR OpenImmo: ausstattung/bad@* |
ausstattung.kueche
|
mehrfach | Küche (EBK = Einbauküche) Werte (ID Code): 41001 EBK, 41002 OFFEN, 41003 PANTRY OpenImmo: ausstattung/kueche@* |
ausstattung.boden
|
mehrfach | Bodenbelag Werte (ID Code): 42001 FLIESEN, 42002 STEIN, 42003 TEPPICH, 42004 PARKETT, 42005 FERTIGPARKETT, 42006 LAMINAT, 42007 DIELEN, 42008 KUNSTSTOFF, 42009 ESTRICH, 42010 DOPPELBODEN, 42011 LINOLEUM, 42012 MARMOR, 42013 TERRAKOTTA, 42014 GRANIT, 42015 VINYL OpenImmo: ausstattung/boden@* |
ausstattung.stellplatzart
|
mehrfach | Art der Stellplätze Werte (ID Code): 43001 GARAGE, 43002 TIEFGARAGE, 43003 CARPORT, 43004 FREIPLATZ, 43005 PARKHAUS, 43006 DUPLEX OpenImmo: ausstattung/stellplatzart@* |
ausstattung.fahrstuhl
|
mehrfach | Aufzug Werte (ID Code): 44001 PERSONEN, 44002 LASTEN OpenImmo: ausstattung/fahrstuhl@* |
ausstattung.ausricht_balkon_terrasse
|
mehrfach | Ausrichtung von Balkon oder Terrasse Werte (ID Code): 45001 NORD, 45002 OST, 45003 SUED, 45004 WEST, 45005 NORDOST, 45006 NORDWEST, 45007 SUEDOST, 45008 SUEDWEST OpenImmo: ausstattung/ausricht_balkon_terrasse@* |
ausstattung.dachform
|
mehrfach | Dachform Werte (ID Code): 46001 KRUEPPELWALMDACH, 46002 MANSARDDACH, 46003 PULTDACH, 46004 SATTELDACH, 46005 WALMDACH, 46006 FLACHDACH, 46007 PYRAMIDENDACH OpenImmo: ausstattung/dachform@* |
ausstattung.bauweise
|
mehrfach | Bauweise Werte (ID Code): 47001 MASSIV, 47002 FERTIGTEILE, 47003 HOLZ OpenImmo: ausstattung/bauweise@* |
ausstattung.ausbaustufe
|
mehrfach | Ausbaustufe (Haus) Werte (ID Code): 48001 BAUSATZHAUS, 48002 AUSBAUHAUS, 48003 SCHLUESSELFERTIGMITKELLER, 48004 SCHLUESSELFERTIGOHNEBODENPLATTE, 48005 SCHLUESSELFERTIGMITBODENPLATTE OpenImmo: ausstattung/ausbaustufe@* |
ausstattung.moebliert
|
auswahl | Möbliert Werte (ID Code): 49001 VOLL, 49002 TEIL OpenImmo: ausstattung/moebliert@moeb |
ausstattung.unterkellert
|
auswahl | Unterkellert Werte (ID Code): 50001 JA, 50002 NEIN, 50003 TEIL OpenImmo: ausstattung/unterkellert@keller |
ausstattung.breitband_art
|
text bis 60 Zeichen |
Breitbandzugang (z. B. Glasfaser, DSL) OpenImmo: ausstattung/breitband_zugang@art |
ausstattung.breitband_speed
|
zahl 0 … 100000, 2 Nachkommastellen |
Bandbreite in Mbit/s OpenImmo: ausstattung/breitband_zugang@speed |
ausstattung.gartennutzung
|
bool | Garten oder Gartennutzung OpenImmo: ausstattung/gartennutzung |
ausstattung.gaestewc
|
bool | Gäste-WC OpenImmo: ausstattung/gaestewc |
ausstattung.kamin
|
bool | Kamin OpenImmo: ausstattung/kamin |
ausstattung.klimatisiert
|
bool | Klimatisiert OpenImmo: ausstattung/klimatisiert |
ausstattung.barrierefrei
|
bool | Barrierefrei OpenImmo: ausstattung/barrierefrei |
ausstattung.rollstuhlgerecht
|
bool | Rollstuhlgerecht OpenImmo: ausstattung/rollstuhlgerecht |
ausstattung.seniorengerecht
|
bool | Seniorengerecht OpenImmo: ausstattung/seniorengerecht |
ausstattung.wg_geeignet
|
bool | WG-geeignet OpenImmo: ausstattung/wg_geeignet |
ausstattung.sauna
|
bool | Sauna OpenImmo: ausstattung/sauna |
ausstattung.swimmingpool
|
bool | Pool OpenImmo: ausstattung/swimmingpool |
ausstattung.wellnessbereich
|
bool | Wellnessbereich OpenImmo: ausstattung/wellnessbereich |
ausstattung.wintergarten
|
bool | Wintergarten OpenImmo: ausstattung/wintergarten |
ausstattung.abstellraum
|
bool | Abstellraum OpenImmo: ausstattung/abstellraum |
ausstattung.dachboden
|
bool | Dachboden OpenImmo: ausstattung/dachboden |
ausstattung.fahrradraum
|
bool | Fahrradraum OpenImmo: ausstattung/fahrradraum |
ausstattung.wasch_trockenraum
|
bool | Wasch- oder Trockenraum OpenImmo: ausstattung/wasch_trockenraum |
ausstattung.rolladen
|
bool | Rollläden OpenImmo: ausstattung/rolladen |
ausstattung.kabel_sat_tv
|
bool | Kabel- oder Satellitenfernsehen OpenImmo: ausstattung/kabel_sat_tv |
ausstattung.bibliothek
|
bool | Bibliothek OpenImmo: ausstattung/bibliothek |
ausstattung.teekueche
|
bool | Teeküche (Gewerbe) OpenImmo: ausstattung/teekueche |
ausstattung.energietyp
|
mehrfach | Energie-Standard (KfW, Passivhaus …); gespeichert wird der erste Wert Werte (ID Code): 39001 PASSIVHAUS, 39002 NIEDRIGENERGIE, 39003 NEUBAUSTANDARD, 39004 KFW40, 39005 KFW60, 39006 KFW55, 39007 KFW70, 39008 MINERGIEBAUWEISE, 39009 MINERGIE_ZERTIFIZIERT OpenImmo: ausstattung/energietyp@* |
ausstattung.raeume_veraenderbar
|
bool | Räume veränderbar OpenImmo: ausstattung/raeume_veraenderbar |
ausstattung.dv_verkabelung
|
bool | DV-Verkabelung OpenImmo: ausstattung/dv_verkabelung |
ausstattung.kabelkanaele
|
bool | Kabelkanäle OpenImmo: ausstattung/kabelkanaele |
ausstattung.dvbt
|
bool | DVB-T-Empfang OpenImmo: ausstattung/dvbt |
ausstattung.umts_empfang
|
bool | Mobilfunkempfang OpenImmo: ausstattung/umts_empfang |
ausstattung.telefon_ferienimmobilie
|
bool | Telefon vorhanden OpenImmo: ausstattung/telefon_ferienimmobilie |
ausstattung.rampe
|
bool | Laderampe OpenImmo: ausstattung/rampe |
ausstattung.hebebuehne
|
bool | Hebebühne OpenImmo: ausstattung/hebebuehne |
ausstattung.kran
|
bool | Kran OpenImmo: ausstattung/kran |
ausstattung.hallenhoehe
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Hallenhöhe in m OpenImmo: ausstattung/hallenhoehe |
ausstattung.stromanschlusswert
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Stromanschlusswert in kW OpenImmo: ausstattung/stromanschlusswert |
ausstattung.gastterrasse
|
bool | Gastterrasse OpenImmo: ausstattung/gastterrasse |
ausstattung.kantine_cafeteria
|
bool | Kantine/Cafeteria OpenImmo: ausstattung/kantine_cafeteria |
ausstattung.brauereibindung
|
bool | Brauereibindung OpenImmo: ausstattung/brauereibindung |
ausstattung.sporteinrichtungen
|
bool | Sporteinrichtungen OpenImmo: ausstattung/sporteinrichtungen |
ausstattung.angeschl_gastronomie
|
mehrfach | Angeschlossene Gastronomie Werte (ID Code): 95001 HOTELRESTAURANT, 95002 BAR OpenImmo: ausstattung/angeschl_gastronomie@* |
ausstattung.serviceleistungen
|
mehrfach | Serviceleistungen Werte (ID Code): 93001 BETREUTES_WOHNEN, 93002 CATERING, 93003 REINIGUNG, 93004 EINKAUF, 93005 WACHDIENST OpenImmo: ausstattung/serviceleistungen@* |
ausstattung.sicherheitstechnik
|
mehrfach | Sicherheitstechnik Werte (ID Code): 94001 ALARMANLAGE, 94002 KAMERA, 94003 POLIZEIRUF OpenImmo: ausstattung/sicherheitstechnik@* |
Zustand und Energieausweis
| Feld | Typ | Beschreibung |
|---|---|---|
zustand_angaben.baujahr
aktiv
|
ganzzahl 1000 … 2100 |
Baujahr OpenImmo: zustand_angaben/baujahr |
zustand_angaben.letztemodernisierung
|
ganzzahl 1000 … 2100 |
Jahr der letzten Modernisierung OpenImmo: zustand_angaben/letztemodernisierung |
zustand_angaben.zustand
|
auswahl | Zustand Werte (ID Code): 29001 ERSTBEZUG, 29002 TEIL_VOLLRENOVIERUNGSBED, 29003 NEUWERTIG, 29004 TEIL_VOLLSANIERT, 29005 TEIL_VOLLRENOVIERT, 29006 TEIL_SANIERT, 29007 VOLL_SANIERT, 29008 SANIERUNGSBEDUERFTIG, 29009 BAUFAELLIG, 29010 NACH_VEREINBARUNG, 29011 MODERNISIERT, 29012 GEPFLEGT, 29013 ROHBAU, 29014 ENTKERNT, 29015 ABRISSOBJEKT, 29016 PROJEKTIERT OpenImmo: zustand_angaben/zustand@zustand_art |
zustand_angaben.alter
|
auswahl | Altbau oder Neubau Werte (ID Code): 31001 ALTBAU, 31002 NEUBAU OpenImmo: zustand_angaben/alter@alter_attr |
zustand_angaben.erschliessung
|
auswahl | Erschließung (Grundstück) Werte (ID Code): 53001 UNERSCHLOSSEN, 53002 TEILERSCHLOSSEN, 53003 VOLLERSCHLOSSEN, 53004 ORTSUEBLICHERSCHLOSSEN OpenImmo: zustand_angaben/erschliessung@erschl_attr |
zustand_angaben.bebaubar_nach
|
auswahl | Bebaubar nach Werte (ID Code): 54001 34_NACHBARSCHAFT, 54002 35_AUSSENGEBIET, 54003 B_PLAN, 54004 KEIN BAULAND, 54005 BAUERWARTUNGSLAND, 54006 LAENDERSPEZIFISCH, 54007 BAULAND_OHNE_B_PLAN OpenImmo: zustand_angaben/bebaubar_nach@bebaubar_attr |
zustand_angaben.bauzone
|
text bis 120 Zeichen |
Bauzone OpenImmo: zustand_angaben/bauzone |
zustand_angaben.altlasten
|
text bis 300 Zeichen |
Altlasten OpenImmo: zustand_angaben/altlasten |
zustand_angaben.verkaufstatus
|
auswahl | Verkaufsstand. VERKAUFT nimmt das Objekt aus der Suche (Status verkauft bzw. vermietet) Werte (ID Code): 56001 OFFEN, 56002 RESERVIERT, 56003 VERKAUFT OpenImmo: zustand_angaben/verkaufstatus@stand |
zustand_angaben.energiepass.epart
aktiv
|
auswahl | Art des Energieausweises Werte (ID Code): 35001 BEDARF, 35002 VERBRAUCH OpenImmo: zustand_angaben/energiepass/epart |
zustand_angaben.energiepass.jahrgang
|
auswahl | Fassung des Ausweises: 2008, 2014, 2026, „ohne“ (kein Ausweis), „nicht_noetig“ (nicht erforderlich, z. B. Denkmal), „bei_besichtigung“ Werte (ID Code): 36001 2008, 36002 2014, 36003 2026, 36004 ohne, 36005 nicht_noetig, 36006 bei_besichtigung OpenImmo: zustand_angaben/energiepass/jahrgang |
zustand_angaben.energiepass.gebaeudeart
|
auswahl | Wohn- oder Nichtwohngebäude Werte (ID Code): 37001 wohn, 37002 nichtwohn OpenImmo: zustand_angaben/energiepass/gebaeudeart |
zustand_angaben.energiepass.gueltig_bis
|
datum | Gültig bis OpenImmo: zustand_angaben/energiepass/gueltig_bis |
zustand_angaben.energiepass.ausstelldatum
|
datum | Ausgestellt am OpenImmo: zustand_angaben/energiepass/ausstelldatum |
zustand_angaben.energiepass.energieverbrauchkennwert
aktiv
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Energieverbrauchskennwert in kWh/(m²·a) (bei epart VERBRAUCH) OpenImmo: zustand_angaben/energiepass/energieverbrauchkennwert |
zustand_angaben.energiepass.endenergiebedarf
aktiv
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Endenergiebedarf in kWh/(m²·a) (bei epart BEDARF) OpenImmo: zustand_angaben/energiepass/endenergiebedarf |
zustand_angaben.energiepass.primaerenergiebedarf
|
zahl 0 … 99999999.99, 2 Nachkommastellen |
Primärenergiebedarf in kWh/(m²·a) OpenImmo: zustand_angaben/energiepass/primaerenergiebedarf |
zustand_angaben.energiepass.primaerenergietraeger
aktiv
|
auswahl | Wesentlicher Energieträger Werte (ID Code): 34001 GAS, 34002 OEL, 34003 FERN, 34004 ERDWAERME, 34005 LUFTWP, 34006 SOLAR, 34007 PELLET, 34008 HOLZ, 34009 ELEKTRO, 34010 BLOCK, 34011 FLUESSIGGAS, 34012 KOHLE, 34013 ALTERNATIV, 34014 ERDGAS_LEICHT, 34015 ERDGAS_SCHWER, 34016 NAHWAERME, 34017 FERN_DAMPF, 34018 WAERMEPUMPE, 34019 HACKSCHNITZEL, 34020 KWK_FOSSIL, 34021 KWK_ERNEUERBAR, 34022 BIOENERGIE, 34023 UMWELTWAERME, 34024 WINDENERGIE, 34025 WASSERKRAFT, 34026 KOKS OpenImmo: zustand_angaben/energiepass/primaerenergietraeger |
zustand_angaben.energiepass.wertklasse
|
auswahl | Energieeffizienzklasse Werte: A+, A, B, C, D, E, F, G, H OpenImmo: zustand_angaben/energiepass/wertklasse |
zustand_angaben.energiepass.mitwarmwasser
|
bool | Kennwert enthält Warmwasser OpenImmo: zustand_angaben/energiepass/mitwarmwasser |
zustand_angaben.energiepass.baujahr
|
ganzzahl 1900 … 2100 |
Baujahr der Heizungsanlage OpenImmo: zustand_angaben/energiepass/baujahr |
zustand_angaben.energiepass.hwbwert
|
zahl 0 … 999999.99, 2 Nachkommastellen |
Heizwärmebedarf HWB (Österreich) OpenImmo: zustand_angaben/energiepass/hwbwert |
zustand_angaben.energiepass.hwbklasse
|
text bis 5 Zeichen |
HWB-Klasse (Österreich) OpenImmo: zustand_angaben/energiepass/hwbklasse |
zustand_angaben.energiepass.fgeewert
|
zahl 0 … 999.99, 2 Nachkommastellen |
Gesamtenergieeffizienzfaktor fGEE (Österreich) OpenImmo: zustand_angaben/energiepass/fgeewert |
zustand_angaben.energiepass.fgeeklasse
|
text bis 5 Zeichen |
fGEE-Klasse (Österreich) OpenImmo: zustand_angaben/energiepass/fgeeklasse |
zustand_angaben.energiepass.geg2018
|
text bis 255 Zeichen |
Energieausweis nach GEG OpenImmo: zustand_angaben/energiepass/geg2018 |
zustand_angaben.energiepass.stromwert
|
text bis 255 Zeichen |
Stromwert OpenImmo: zustand_angaben/energiepass/stromwert |
zustand_angaben.energiepass.waermewert
|
text bis 255 Zeichen |
Wärmewert OpenImmo: zustand_angaben/energiepass/waermewert |
zustand_angaben.energiepass.epasstext
|
text bis 255 Zeichen |
Hinweis zum Energieausweis OpenImmo: zustand_angaben/energiepass/epasstext |
Umfeld
| Feld | Typ | Beschreibung |
|---|---|---|
infrastruktur.ausblick
|
auswahl | Ausblick Werte (ID Code): 57001 FERNE, 57002 SEE, 57003 BERGE, 57004 MEER OpenImmo: infrastruktur/ausblick@blick |
infrastruktur.zulieferung
|
bool | Zulieferung möglich (Gewerbe) OpenImmo: infrastruktur/zulieferung |
infrastruktur.distanzen
|
liste | Entfernungen in km: Liste aus {ziel, km}. ziel: FLUGHAFEN, FERNBAHNHOF, AUTOBAHN, US_BAHN, BUS, KINDERGAERTEN, GRUNDSCHULE, HAUPTSCHULE, REALSCHULE, GESAMTSCHULE, GYMNASIUM, ZENTRUM, EINKAUFSMOEGLICHKEITEN, GASTSTAETTEN OpenImmo: infrastruktur/distanzen |
infrastruktur.distanzen_sport
|
liste | Entfernungen in km: Liste aus {ziel, km}. ziel: STRAND, SEE, MEER, SKIGEBIET, SPORTANLAGEN, WANDERGEBIETE, NAHERHOLUNG OpenImmo: infrastruktur/distanzen_sport |
Texte
| Feld | Typ | Beschreibung |
|---|---|---|
freitexte.objekttitel
immer
|
text bis 255 Zeichen |
Überschrift des Inserats OpenImmo: freitexte/objekttitel |
freitexte.dreizeiler
|
text bis 500 Zeichen |
Kurzbeschreibung (drei Zeilen) OpenImmo: freitexte/dreizeiler |
freitexte.objektbeschreibung
|
text bis 20000 Zeichen |
Objektbeschreibung (Absätze mit Leerzeile, kein HTML) OpenImmo: freitexte/objektbeschreibung |
freitexte.lage
|
text bis 20000 Zeichen |
Lagebeschreibung OpenImmo: freitexte/lage |
freitexte.ausstatt_beschr
|
text bis 20000 Zeichen |
Ausstattungsbeschreibung OpenImmo: freitexte/ausstatt_beschr |
freitexte.sonstige_angaben
|
text bis 20000 Zeichen |
Sonstige Angaben OpenImmo: freitexte/sonstige_angaben |
Bilder, Grundrisse, Dokumente
| Feld | Typ | Beschreibung |
|---|---|---|
anhaenge
aktiv
|
liste | Bilder und Dokumente in Anzeigereihenfolge: Liste aus {gruppe, titel, url} oder {gruppe, titel, medien_id} (Upload über POST /v1/medien). Die Lieferung ist vollständig: was fehlt, wird entfernt. Mindestens ein Bild ist nötig, damit das Objekt online geht OpenImmo: anhaenge/anhang |
Verfügbarkeit und Vermietung
| Feld | Typ | Beschreibung |
|---|---|---|
verwaltung_objekt.objektadresse_freigeben
|
bool | Straße und Hausnummer im Inserat zeigen (Standard: ja) OpenImmo: verwaltung_objekt/objektadresse_freigeben |
verwaltung_objekt.verfuegbar_ab
|
text bis 120 Zeichen |
Verfügbar ab (Text, z. B. „sofort“) OpenImmo: verwaltung_objekt/verfuegbar_ab |
verwaltung_objekt.abdatum
|
datum | Verfügbar ab (Datum) OpenImmo: verwaltung_objekt/abdatum |
verwaltung_objekt.bisdatum
|
datum | Verfügbar bis (Datum) OpenImmo: verwaltung_objekt/bisdatum |
verwaltung_objekt.min_mietdauer
|
ganzzahl 0 … 9999 |
Mindestmietdauer (Anzahl) OpenImmo: verwaltung_objekt/min_mietdauer |
verwaltung_objekt.min_mietdauer_einheit
|
auswahl | Einheit der Mindestmietdauer Werte (ID Code): 58001 TAG, 58002 WOCHE, 58003 MONAT, 58004 JAHR OpenImmo: verwaltung_objekt/min_mietdauer@min_dauer |
verwaltung_objekt.max_mietdauer
|
ganzzahl 0 … 9999 |
Höchstmietdauer (Anzahl) OpenImmo: verwaltung_objekt/max_mietdauer |
verwaltung_objekt.max_mietdauer_einheit
|
auswahl | Einheit der Höchstmietdauer Werte (ID Code): 58001 TAG, 58002 WOCHE, 58003 MONAT, 58004 JAHR OpenImmo: verwaltung_objekt/max_mietdauer@max_dauer |
verwaltung_objekt.max_personen
|
ganzzahl 0 … 9999 |
Höchstzahl Personen OpenImmo: verwaltung_objekt/max_personen |
verwaltung_objekt.vermietet
|
bool | Vermietet (Kapitalanlage) OpenImmo: verwaltung_objekt/vermietet |
verwaltung_objekt.wbs_sozialwohnung
|
bool | Wohnberechtigungsschein erforderlich OpenImmo: verwaltung_objekt/wbs_sozialwohnung |
verwaltung_objekt.denkmalgeschuetzt
|
bool | Denkmalgeschützt (entbindet vom Energieausweis) OpenImmo: verwaltung_objekt/denkmalgeschuetzt |
verwaltung_objekt.haustiere
|
bool | Haustiere erlaubt OpenImmo: verwaltung_objekt/haustiere |
verwaltung_objekt.nichtraucher
|
bool | Nur Nichtraucher OpenImmo: verwaltung_objekt/nichtraucher |
verwaltung_objekt.als_ferien
|
bool | Als Ferienimmobilie nutzbar OpenImmo: verwaltung_objekt/als_ferien |
verwaltung_objekt.gewerbliche_nutzung
|
bool | Gewerbliche Nutzung möglich OpenImmo: verwaltung_objekt/gewerbliche_nutzung |
verwaltung_objekt.hochhaus
|
bool | Hochhaus OpenImmo: verwaltung_objekt/hochhaus |
verwaltung_objekt.versteigerungstermin
|
datum | Versteigerungstermin (Datum) OpenImmo: verwaltung_objekt/versteigerungstermin |
verwaltung_objekt.zugang
|
text bis 255 Zeichen |
Zugang ab OpenImmo: verwaltung_objekt/zugang |
verwaltung_objekt.laufzeit
|
zahl 0 … 9999999999.99, 2 Nachkommastellen |
Restlaufzeit Erbpacht in Jahre OpenImmo: verwaltung_objekt/laufzeit |
verwaltung_objekt.branchen
|
text bis 255 Zeichen |
Geeignete Branchen OpenImmo: verwaltung_objekt/branchen |
verwaltung_objekt.geschlecht_geschl_attr
|
auswahl | Vermietung an Werte (ID Code): 96001 EGAL, 96002 NUR_MANN, 96003 NUR_FRAU OpenImmo: verwaltung_objekt/geschlecht@geschl_attr |
Kennungen
| Feld | Typ | Beschreibung |
|---|---|---|
verwaltung_techn.objektnr_extern
|
text bis 191 Zeichen |
Ihre Objektnummer, wie sie im Exposé stehen soll OpenImmo: verwaltung_techn/objektnr_extern |
verwaltung_techn.objektnr_intern
|
text bis 191 Zeichen |
Interne Objektnummer (nicht öffentlich) OpenImmo: verwaltung_techn/objektnr_intern |
Zusatzfelder
| Feld | Typ | Beschreibung |
|---|---|---|
zusatzfelder
|
zusatz | Weitere Angaben als Name → Text (höchstens 50, Name bis 60 Zeichen, Text bis 1.000). Erscheinen unter „Weitere Angaben“, wenn das Portal den Namen kennt OpenImmo: verwaltung_objekt/user_defined_simplefield@feldname |
Objektarten und Untertypen
objektkategorie.objektart.typ ist das Element unter <objektart>, untertyp dessen Attribut. Beispiel: {"typ": "haus", "untertyp": "DOPPELHAUSHAELFTE"} wird zu <haus haustyp="DOPPELHAUSHAELFTE"/>.
| typ | untertyp (ID Code) |
|---|---|
wohnung ID 10001@wohnungtyp |
12001 DACHGESCHOSS, 12002 MAISONETTE, 12003 LOFT-STUDIO-ATELIER, 12004 PENTHOUSE, 12005 TERRASSEN, 12006 ETAGE, 12007 ERDGESCHOSS, 12008 SOUTERRAIN, 12009 APARTMENT, 12010 FERIENWOHNUNG, 12011 GALERIE, 12012 ROHDACHBODEN, 12013 ATTIKAWOHNUNG, 12014 KEINE_ANGABE |
haus ID 10002@haustyp |
13001 REIHENHAUS, 13002 REIHENEND, 13003 REIHENMITTEL, 13004 REIHENECK, 13005 DOPPELHAUSHAELFTE, 13006 EINFAMILIENHAUS, 13007 STADTHAUS, 13008 BUNGALOW, 13009 VILLA, 13010 RESTHOF, 13011 BAUERNHAUS, 13012 LANDHAUS, 13013 SCHLOSS, 13014 ZWEIFAMILIENHAUS, 13015 MEHRFAMILIENHAUS, 13016 FERIENHAUS, 13017 BERGHUETTE, 13018 CHALET, 13019 STRANDHAUS, 13020 LAUBE-DATSCHE-GARTENHAUS, 13021 APARTMENTHAUS, 13022 BURG, 13023 HERRENHAUS, 13024 FINCA, 13025 RUSTICO, 13026 FERTIGHAUS, 13027 KEINE_ANGABE |
grundstueck ID 10003@grundst_typ |
14001 WOHNEN, 14002 GEWERBE, 14003 INDUSTRIE, 14004 LAND_FORSTWIRSCHAFT, 14005 FREIZEIT, 14006 GEMISCHT, 14007 GEWERBEPARK, 14008 SONDERNUTZUNG, 14009 SEELIEGENSCHAFT |
zimmer ID 10004@zimmertyp |
11001 ZIMMER |
buero_praxen ID 10005@buero_typ |
15001 BUEROFLAECHE, 15002 BUEROHAUS, 15003 BUEROZENTRUM, 15004 LOFT_ATELIER, 15005 PRAXIS, 15006 PRAXISFLAECHE, 15007 PRAXISHAUS, 15008 AUSSTELLUNGSFLAECHE, 15009 COWORKING, 15010 SHARED_OFFICE |
einzelhandel ID 10006@handel_typ |
16001 LADENLOKAL, 16002 EINZELHANDELSLADEN, 16003 VERBRAUCHERMARKT, 16004 EINKAUFSZENTRUM, 16005 KAUFHAUS, 16006 FACTORY_OUTLET, 16007 KIOSK, 16008 VERKAUFSFLAECHE, 16009 AUSSTELLUNGSFLAECHE |
gastgewerbe ID 10007@gastgew_typ |
17001 GASTRONOMIE, 17002 GASTRONOMIE_UND_WOHNUNG, 17003 PENSIONEN, 17004 HOTELS, 17005 WEITERE_BEHERBERGUNGSBETRIEBE, 17006 BAR, 17007 CAFE, 17008 DISCOTHEK, 17009 RESTAURANT, 17010 RAUCHERLOKAL, 17011 EINRAUMLOKAL |
hallen_lager_prod ID 10008@hallen_typ |
18001 HALLE, 18002 INDUSTRIEHALLE, 18003 LAGER, 18004 LAGERFLAECHEN, 18005 LAGER_MIT_FREIFLAECHE, 18006 HOCHREGALLAGER, 18007 SPEDITIONSLAGER, 18008 PRODUKTION, 18009 WERKSTATT, 18010 SERVICE, 18011 FREIFLAECHEN, 18012 KUEHLHAUS |
land_und_forstwirtschaft ID 10009@land_typ |
19001 LANDWIRTSCHAFTLICHE_BETRIEBE, 19002 BAUERNHOF, 19003 AUSSIEDLERHOF, 19004 GARTENBAU, 19005 ACKERBAU, 19006 WEINBAU, 19007 VIEHWIRTSCHAFT, 19008 JAGD_UND_FORSTWIRTSCHAFT, 19009 TEICH_UND_FISCHWIRTSCHAFT, 19010 SCHEUNEN, 19011 REITERHOEFE, 19012 SONSTIGE_LANDWIRTSCHAFTSIMMOBILIEN, 19013 ANWESEN, 19014 JAGDREVIER |
parken ID 10010@parken_typ |
20001 STELLPLATZ, 20002 CARPORT, 20003 DOPPELGARAGE, 20004 DUPLEX, 20005 TIEFGARAGE, 20006 BOOTSLIEGEPLATZ, 20007 EINZELGARAGE, 20008 PARKHAUS, 20009 TIEFGARAGENSTELLPLATZ, 20010 PARKPLATZ_STROM |
sonstige ID 10011@sonstige_typ |
21001 PARKHAUS, 21002 TANKSTELLE, 21003 KRANKENHAUS, 21004 SONSTIGE |
freizeitimmobilie_gewerblich ID 10012@freizeit_typ |
22001 SPORTANLAGEN, 22002 VERGNUEGUNGSPARKS_UND_CENTER, 22003 FREIZEITANLAGE |
zinshaus_renditeobjekt ID 10013@zins_typ |
23001 MEHRFAMILIENHAUS, 23002 WOHN_UND_GESCHAEFTSHAUS, 23003 GESCHAEFTSHAUS, 23004 BUEROGEBAEUDE, 23005 SB_MAERKTE, 23006 EINKAUFSCENTREN, 23007 WOHNANLAGEN, 23008 VERBRAUCHERMAERKTE, 23009 INDUSTRIEANLAGEN, 23010 PFLEGEHEIM, 23011 SANATORIUM, 23012 SENIORENHEIM, 23013 BETREUTES-WOHNEN |
Fehler
Fehler kommen als application/problem+json (RFC 9457). Maßgeblich ist code: Er ändert sich innerhalb von v1 nicht. title und detail sind für Menschen und folgen Accept-Language. anfrage_id nennen Sie uns bei Rückfragen; sie steht auch in der Kopfzeile X-Request-Id jeder Antwort.
| code | Bedeutung |
|---|---|
nicht_gefunden | Nicht gefunden Diese Adresse gibt es in der API nicht. |
methode_nicht_erlaubt | Methode nicht erlaubt Die Adresse kennt diese Methode nicht, siehe Kopfzeile Allow. |
schluessel_fehlt | Schlüssel fehlt Senden Sie Ihren Schlüssel als „Authorization: Bearer ir_live_…“. |
schluessel_ungueltig | Schlüssel ungültig Der Schlüssel ist unbekannt oder widerrufen. |
ip_nicht_erlaubt | IP nicht freigegeben Für diesen Schlüssel ist eine IP-Liste hinterlegt, die diese Adresse nicht enthält. |
testschluessel_nur_testobjekte | Nur Testobjekte Ein Testschlüssel ändert nur Objekte, die nie öffentlich waren. Für veröffentlichte Objekte einen Live-Schlüssel verwenden. |
recht_fehlt | Recht fehlt Dem Schlüssel fehlt das Recht für diese Anfrage. |
kein_api_zugang | Kein API-Zugang Ihr Paket enthält keinen API-Zugang. Die API gehört zu allen Makler- und Bauträgerpaketen. |
firma_nicht_freigegeben | Firma nicht freigegeben Ihre Firma ist noch nicht geprüft oder gesperrt. |
zu_viele_anfragen | Zu viele Anfragen Das Anfragelimit ist erreicht. Wiederholen Sie nach Retry-After Sekunden. |
zu_viele_fehlversuche | Zu viele Fehlversuche Zu viele ungültige Schlüssel von dieser Adresse. Warten Sie zehn Minuten. |
zu_gross | Anfrage zu groß JSON-Anfragen dürfen höchstens 2 MB groß sein. Bilder gehen über POST /v1/medien, OpenImmo-Dateien über POST /v1/openimmo. |
json_erwartet | JSON erwartet Senden Sie Content-Type: application/json. |
json_ungueltig | Ungültiges JSON Der Körper ist kein gültiges JSON-Objekt. |
pruefung_fehlgeschlagen | Prüfung fehlgeschlagen Mindestens ein Feld ist fehlerhaft, siehe fehler. |
idempotenz_konflikt | Idempotency-Key wiederverwendet Derselbe Idempotency-Key kam mit einem anderen Körper. |
objekt_nicht_gefunden | Objekt nicht gefunden Ihre Firma hat kein Objekt mit dieser Kennung. |
lieferung_nicht_gefunden | Lieferung nicht gefunden Ihre Firma hat keine Lieferung mit dieser Nummer. |
anfrage_nicht_gefunden | Anfrage nicht gefunden Ihre Firma hat keine Anfrage mit dieser Nummer. |
pflichtangaben_fehlen | Pflichtangaben fehlen Das Objekt kann so nicht online gehen, siehe fehlend. |
kontingent_erschoepft | Kontingent erschöpft Ihr Paket erlaubt nicht mehr gleichzeitig aktive Objekte. Pausieren Sie eines oder wählen Sie ein größeres Paket. |
kein_paket | Kein Paket Ihre Firma hat kein laufendes Paket. |
laufzeit_abgelaufen | Laufzeit abgelaufen Die Laufzeit des Objekts ist abgelaufen. |
firma_ungeprueft | Firma noch nicht geprüft Objekte gehen erst online, wenn die Firma geprüft ist. Bis dahin bleiben sie Entwurf. |
als_verkauft_gemeldet | Als verkauft gemeldet Das Objekt ist als verkauft gemeldet (verkaufstatus VERKAUFT). |
unbekannter_status | Unbekannter Status Erlaubt: aktiv, entwurf, pausiert, verkauft, vermietet, archiviert. |
medium_ungueltig | Datei nicht verwertbar Erlaubt sind JPEG, PNG, WebP und PDF bis 15 MB. |
datei_erwartet | Datei erwartet Senden Sie die Datei als multipart/form-data (Feld datei) oder als Körper mit passendem Content-Type. |
openimmo_erwartet | OpenImmo erwartet Senden Sie OpenImmo-XML (application/xml) oder ein ZIP mit XML und Bildern (application/zip). |
nicht_erlaubt | Nicht erlaubt Diese Änderung ist nicht erlaubt. |
serverfehler | Serverfehler Ein unerwarteter Fehler. Wir sind benachrichtigt; nennen Sie bei Rückfragen die anfrage_id. |
Feldfehler in fehler[] tragen pfad und code: pflichtfeld, unbekanntes_feld, typ_text, typ_zahl, typ_ganzzahl, typ_bool, typ_datum, typ_liste, typ_objekt, zu_lang, zu_klein, zu_gross, unbekannter_wert, zu_viele, doppelt, format_email, format_url, kauf_oder_miete, url_oder_medien_id, untertyp_ohne_typ, zusatzname. Hinweise in hinweise[] (preis_fehlt, miete_fehlt, ohne_bild) verhindern nichts, das Objekt bleibt nur Entwurf.
curl -X PATCH "https://api.immoriver.com/v1/objekte/DOKU-4711" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL"Antwort anzeigen (HTTP 405)
HTTP 405
Content-Type: application/problem+json; charset=UTF-8
Allow: GET, PUT, DELETE
{
"type": "https://immoriver.com/entwickler#fehler-methode_nicht_erlaubt",
"title": "Methode nicht erlaubt",
"status": 405,
"code": "methode_nicht_erlaubt",
"detail": "Die Adresse kennt diese Methode nicht, siehe Kopfzeile Allow.",
"anfrage_id": "00MUHKGEYL1E2EFEC884EC409B"
}Grenzen
| Lesen | 120 Anfragen je Minute und Schlüssel |
|---|---|
| Schreiben | 60 je Minute |
| Uploads und OpenImmo | 30 je Minute |
| Je Tag | 20.000 Anfragen je Schlüssel |
| Körper | JSON bis 2 MB, Bilder bis 15 MB, OpenImmo-ZIP bis 100 MB |
| Anhänge | 80 je Objekt; Zusatzfelder 50 |
Jede Antwort mit Schlüssel trägt RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset (Sekunden bis zum nächsten Fenster). Über der Grenze antwortet die API mit 429 und Retry-After. Warten Sie dann die angegebenen Sekunden.
OpenImmo und FTP
Erzeugt Ihre Software schon OpenImmo, schicken Sie die Datei direkt: POST /v1/openimmo mit Content-Type: application/xml, oder als ZIP mit XML und Bildern (application/zip, bis 100 MB). Sie läuft genau wie eine FTP-Lieferung, einschließlich Prüfung der Anbieterkennung und der Direktfreigabe nach Ihrer Firmeneinstellung. Schweizer Software mit IDX 3.01 liefert weiterhin per FTP.
curl -X POST "https://api.immoriver.com/v1/openimmo?warten=20" \
-H "Authorization: Bearer $IMMORIVER_SCHLUESSEL" \
-H "Content-Type: application/zip" \
--data-binary @lieferung.zip
ChatGPT und KI-Assistenten (MCP)
Neben der API für Anbieter gibt es einen öffentlichen MCP-Server (Model Context Protocol). Über ihn können ChatGPT, Claude und andere KI-Assistenten die aktuellen Angebote auf immoriver.com durchsuchen und einzelne Exposés abrufen. Er ist nur lesend und braucht keinen Schlüssel. Kontaktdaten der Anbieter und Anfragen gibt es darüber nicht; dafür verweist jede Antwort auf das Exposé.
| Adresse | https://immoriver.com/mcp |
|---|---|
| Transport | Streamable HTTP, JSON-RPC 2.0 per POST, Antworten als JSON |
| Anmeldung | keine |
search_properties | Angebote suchen nach Ort, Kauf oder Miete, Objektart, Preis, Zimmern, Fläche, Umkreis, Land und Stichwort. Bis zu 10 Treffer mit Gesamtzahl und Link zur vollen Suche. |
get_property | Ein Exposé nach Nummer: Preise, Flächen, Zimmer, Baujahr, Energie, Beschreibung und Fotos. |
| Grenzen | 60 Nachrichten je Minute und Netz, höchstens 10 je Stapel, Anfrage bis 64 KB |
| Serverbeschreibung | /.well-known/mcp/server-card.json |
Die Treffer sind neutral sortiert: neueste zuerst, auf Wunsch nach Preis oder Fläche, nie nach bezahlter Platzierung. Ein Aufruf zum Ausprobieren:
curl -X POST https://immoriver.com/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_properties","arguments":{"location":"Köln","transaction":"buy","rooms_min":3}}}'
Code-Beispiele
Dasselbe Objekt aus objekt.json liefern, in drei Sprachen. Den Schlüssel lesen die Beispiele aus der Umgebung, nicht aus dem Quelltext.
PHP
<?php
$schluessel = getenv('IMMORIVER_SCHLUESSEL');
$objekt = file_get_contents('objekt.json');
$ch = curl_init('https://api.immoriver.com/v1/objekte/DOKU-4711?warten=20');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_POSTFIELDS => $objekt,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $schluessel,
'Content-Type: application/json',
],
]);
$antwort = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status === 422) {
foreach ($antwort['fehler'] as $f) {
echo $f['pfad'], ': ', $f['meldung'], "\n";
}
} else {
$o = $antwort['objekte'][0];
echo $o['ergebnis'], ', ', $o['freigabe'], ', ', $o['url'] ?? '-', "\n";
}
JavaScript (Node.js 18+)
import { readFile } from 'node:fs/promises';
const antwort = await fetch('https://api.immoriver.com/v1/objekte/DOKU-4711?warten=20', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.IMMORIVER_SCHLUESSEL}`,
'Content-Type': 'application/json',
},
body: await readFile('objekt.json', 'utf8'),
});
const daten = await antwort.json();
if (antwort.status === 422) {
for (const f of daten.fehler) console.log(`${f.pfad}: ${f.meldung}`);
} else {
const o = daten.objekte[0];
console.log(o.ergebnis, o.freigabe, o.url ?? '-');
}
Python
import json, os, urllib.request
anfrage = urllib.request.Request(
"https://api.immoriver.com/v1/objekte/DOKU-4711?warten=20",
data=open("objekt.json", "rb").read(),
method="PUT",
headers={
"Authorization": "Bearer " + os.environ["IMMORIVER_SCHLUESSEL"],
"Content-Type": "application/json",
},
)
try:
with urllib.request.urlopen(anfrage) as antwort:
o = json.load(antwort)["objekte"][0]
print(o["ergebnis"], o["freigabe"], o.get("url"))
except urllib.error.HTTPError as fehler:
for f in json.load(fehler).get("fehler", []):
print(f["pfad"] + ": " + f["meldung"])
Anfragen abholen (PHP)
<?php
// Alle fünf Minuten per Cron. Der Cursor liegt in einer Datei.
$cursor = @file_get_contents('anfragen.cursor') ?: '';
$ch = curl_init('https://api.immoriver.com/v1/anfragen?nach=' . urlencode($cursor));
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('IMMORIVER_SCHLUESSEL')],
]);
$antwort = json_decode(curl_exec($ch), true);
foreach ($antwort['anfragen'] as $a) {
if ($a['anonymisiert']) {
// Interessent hat die Löschung verlangt: auch im eigenen CRM löschen
continue;
}
// … in Ihr CRM übernehmen: $a['anfragenummer'], $a['interessent'], $a['nachricht']
}
if ($antwort['weiter'] !== null) {
file_put_contents('anfragen.cursor', $antwort['weiter']);
}
Versionen
v1 bleibt stabil: Neue Felder, Werte und Endpunkte kommen hinzu, ohne dass bestehende Anbindungen brechen. Was sich unverträglich ändern müsste, käme als v2 unter neuer Adresse, und v1 liefe weiter. Ignorieren Sie in Antworten unbekannte Felder. Die Version des Feldkatalogs steht in GET /v1 unter feldkatalog.
| 25.09.2026 | v1 (Feldkatalog 1.0): erste Fassung |
Fragen zur Anbindung: support@immoriver.com. Nennen Sie die anfrage_id aus der Antwort.