Zum Inhalt
immoriver
immoriver
Anmelden Konto anlegen

Hilfe · Kontakt · Impressum · Datenschutz

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

Ü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.

Adressehttps://api.immoriver.com/v1
FormatJSON (UTF-8), Zahlen mit Punkt, Datum JJJJ-MM-TT, Zeiten ISO 8601
AnmeldungAuthorization: Bearer ir_live_…
VoraussetzungEin laufendes Makler- oder Bauträgerpaket und eine geprüfte Firma
Sprache der MeldungenAccept-Language: en für Englisch, sonst Deutsch. Feldnamen und Codes sind in beiden gleich.
OpenAPI 3.1openapi.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

  1. Schlüssel anlegen: Im Konto unter Transfer, Abschnitt „Schnittstelle (API)“. Zum Ausprobieren nehmen Sie einen Testschlüssel; damit angelegte Objekte bleiben Entwurf. Zum Konto
  2. 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"
}
  1. 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.json

Antwort

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.

RechtErlaubt
objekte:schreibenObjekte anlegen, ändern, löschen, Status setzen
objekte:lesenEigene Objekte und Lieferungen abrufen
anfragen:lesenAnfragen zu eigenen Objekten abrufen
anfragen:schreibenBearbeitungsstand 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.jpg

Antwort

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.json
Antwort 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.

FeldWerte
statuswartet, laeuft, erfolgreich, teilweise, fehler, abgelehnt
objekte[].ergebnisneu, aktualisiert, unveraendert, geloescht, uebersprungen, fehler
objekte[].freigabeaktiv, entwurf, pflichtangaben_fehlen, kontingent_erschoepft, kein_paket, laufzeit_abgelaufen, als_verkauft_gemeldet
objekte[].fehlendWas 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"/>.

typuntertyp (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.

codeBedeutung
nicht_gefundenNicht gefunden
Diese Adresse gibt es in der API nicht.
methode_nicht_erlaubtMethode nicht erlaubt
Die Adresse kennt diese Methode nicht, siehe Kopfzeile Allow.
schluessel_fehltSchlüssel fehlt
Senden Sie Ihren Schlüssel als „Authorization: Bearer ir_live_…“.
schluessel_ungueltigSchlüssel ungültig
Der Schlüssel ist unbekannt oder widerrufen.
ip_nicht_erlaubtIP nicht freigegeben
Für diesen Schlüssel ist eine IP-Liste hinterlegt, die diese Adresse nicht enthält.
testschluessel_nur_testobjekteNur Testobjekte
Ein Testschlüssel ändert nur Objekte, die nie öffentlich waren. Für veröffentlichte Objekte einen Live-Schlüssel verwenden.
recht_fehltRecht fehlt
Dem Schlüssel fehlt das Recht für diese Anfrage.
kein_api_zugangKein API-Zugang
Ihr Paket enthält keinen API-Zugang. Die API gehört zu allen Makler- und Bauträgerpaketen.
firma_nicht_freigegebenFirma nicht freigegeben
Ihre Firma ist noch nicht geprüft oder gesperrt.
zu_viele_anfragenZu viele Anfragen
Das Anfragelimit ist erreicht. Wiederholen Sie nach Retry-After Sekunden.
zu_viele_fehlversucheZu viele Fehlversuche
Zu viele ungültige Schlüssel von dieser Adresse. Warten Sie zehn Minuten.
zu_grossAnfrage 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_erwartetJSON erwartet
Senden Sie Content-Type: application/json.
json_ungueltigUngültiges JSON
Der Körper ist kein gültiges JSON-Objekt.
pruefung_fehlgeschlagenPrüfung fehlgeschlagen
Mindestens ein Feld ist fehlerhaft, siehe fehler.
idempotenz_konfliktIdempotency-Key wiederverwendet
Derselbe Idempotency-Key kam mit einem anderen Körper.
objekt_nicht_gefundenObjekt nicht gefunden
Ihre Firma hat kein Objekt mit dieser Kennung.
lieferung_nicht_gefundenLieferung nicht gefunden
Ihre Firma hat keine Lieferung mit dieser Nummer.
anfrage_nicht_gefundenAnfrage nicht gefunden
Ihre Firma hat keine Anfrage mit dieser Nummer.
pflichtangaben_fehlenPflichtangaben fehlen
Das Objekt kann so nicht online gehen, siehe fehlend.
kontingent_erschoepftKontingent erschöpft
Ihr Paket erlaubt nicht mehr gleichzeitig aktive Objekte. Pausieren Sie eines oder wählen Sie ein größeres Paket.
kein_paketKein Paket
Ihre Firma hat kein laufendes Paket.
laufzeit_abgelaufenLaufzeit abgelaufen
Die Laufzeit des Objekts ist abgelaufen.
firma_ungeprueftFirma noch nicht geprüft
Objekte gehen erst online, wenn die Firma geprüft ist. Bis dahin bleiben sie Entwurf.
als_verkauft_gemeldetAls verkauft gemeldet
Das Objekt ist als verkauft gemeldet (verkaufstatus VERKAUFT).
unbekannter_statusUnbekannter Status
Erlaubt: aktiv, entwurf, pausiert, verkauft, vermietet, archiviert.
medium_ungueltigDatei nicht verwertbar
Erlaubt sind JPEG, PNG, WebP und PDF bis 15 MB.
datei_erwartetDatei erwartet
Senden Sie die Datei als multipart/form-data (Feld datei) oder als Körper mit passendem Content-Type.
openimmo_erwartetOpenImmo erwartet
Senden Sie OpenImmo-XML (application/xml) oder ein ZIP mit XML und Bildern (application/zip).
nicht_erlaubtNicht erlaubt
Diese Änderung ist nicht erlaubt.
serverfehlerServerfehler
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

Lesen120 Anfragen je Minute und Schlüssel
Schreiben60 je Minute
Uploads und OpenImmo30 je Minute
Je Tag20.000 Anfragen je Schlüssel
KörperJSON bis 2 MB, Bilder bis 15 MB, OpenImmo-ZIP bis 100 MB
Anhänge80 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é.

Adressehttps://immoriver.com/mcp
TransportStreamable HTTP, JSON-RPC 2.0 per POST, Antworten als JSON
Anmeldungkeine
search_propertiesAngebote 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_propertyEin Exposé nach Nummer: Preise, Flächen, Zimmer, Baujahr, Energie, Beschreibung und Fotos.
Grenzen60 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.2026v1 (Feldkatalog 1.0): erste Fassung

Fragen zur Anbindung: support@immoriver.com. Nennen Sie die anfrage_id aus der Antwort.