API-Dokumentation | ImmoFluss

Einführung

Die ImmoFluss API ist eine schlanke REST-Schnittstelle über Deine echten Bestandsdaten. Sie nutzt dieselbe Logik wie der MCP-Server – nur als klassisches HTTP/JSON statt für KI-Clients. Damit automatisierst Du wiederkehrende Aufgaben oder verbindest ImmoFluss mit Tools wie n8n, Zapier oder Make.

Du kannst Immobilien, Mieter, Kredite, Ausgaben, Fahrten und Portfolio-Kennzahlen abrufen und – mit einem Pro- oder Ultra-Abo – auch anlegen, ändern und löschen.

Authentifizierung

Jede Anfrage authentifizierst Du mit einem persönlichen API-Key. Du erstellst ihn in der App unter Konto → Integrationen → API-Zugang. Der Key wird nur bei der Erstellung einmalig im Klartext angezeigt – kopiere ihn Dir also gleich an einen sicheren Ort.

Schicke ihn bei jedem Request im Authorization-Header mit:

Authorization: Bearer imf_sk_…

🔑

Ein API-Key gehört zu genau einem Konto. Behandle ihn wie ein Passwort – teile ihn nicht und lege ihn nicht in öffentlichen Repos ab. Verlorene oder kompromittierte Keys widerrufst Du jederzeit in der App; Anfragen damit schlagen dann sofort fehl.

Alternativ akzeptiert die API auch OAuth-Access-Tokens (imf_at_…) aus einer bestehenden MCP-Verbindung – praktisch, wenn Du ohnehin schon per MCP angebunden bist.

Basis-URL & Format

Alle Endpunkte liegen unter einer versionierten Basis-URL:

https://app.immo-fluss.de/api/v1

Anfragen und Antworten sind JSON (Content-Type: application/json).
Beträge sind in Euro, Datumsangaben im Format YYYY-MM-DD.
IDs (z. B. propertyId) stammen aus den jeweiligen List-Endpunkten.

Limits & Berechtigungen

Jeder Aufruf zählt auf ein gemeinsames Tageskontingent, das Du Dir mit dem MCP-Server teilst. Der Endpunkt /status zählt selbst nicht mit. Das Limit wird um Mitternacht (UTC) zurückgesetzt.

Abo	Aufrufe / Tag	Lesen	Schreiben
Free	25	✓	–
Pro	300	✓	✓
Ultra	2.000	✓	✓

Lesen (GET) ist in jedem Abo möglich. Schreiben (Anlegen, Ändern, Löschen) erfordert ein Pro- oder Ultra-Abo. Ist Dein Konto im Free-Tarif, antworten Schreib-Endpunkte mit 403.

Endpunkte

Lesen (alle Abos)

Methode	Pfad	Beschreibung
GET	`/status`	Konto-Tier & heutiges Kontingent (zählt nicht)
GET	`/properties`	Immobilien auflisten
GET	`/tenants`	Mieter auflisten
GET	`/loans`	Kredite auflisten
GET	`/expenses`	Ausgaben durchsuchen (`query`, `category`, `propertyId`, `year`, `amount`)
GET	`/expenses/breakdown`	Ausgaben-Auswertung (`year`, `propertyId`)
GET	`/pending-receipts`	Offene Belege durchsuchen (`query`, `status`)
GET	`/portfolio`	Portfolio-Kennzahlen
GET	`/fahrten`	Fahrten auflisten (`year`, `propertyId`, `category`)
GET	`/bauzinsen`	Aktuelle Bauzinsen

Schreiben (Pro / Ultra)

Methode	Pfad	Beschreibung
POST	`/expenses`	Ausgabe anlegen
PATCH	`/expenses/{id}`	Ausgabe bearbeiten
DEL	`/expenses/{id}`	Ausgabe löschen
POST	`/fahrten`	Fahrt anlegen (km-Berechnung automatisch)
DEL	`/fahrten/{id}`	Fahrt löschen
POST	`/tenants`	Mieter anlegen
PATCH	`/tenants/{id}`	Mieter bearbeiten
POST	`/loans`	Kredit anlegen
PATCH	`/loans/{id}`	Kredit bearbeiten
POST	`/properties`	Immobilie anlegen
PATCH	`/properties/{id}`	Immobilie bearbeiten

Die vollständigen Felder je Endpunkt findest Du in der OpenAPI-Spezifikation.

Beispiele

Immobilien abrufen

# GET – Liste aller Immobilien
curl -H "Authorization: Bearer imf_sk_…" \
  https://app.immo-fluss.de/api/v1/properties

Kontostatus & Kontingent prüfen

curl -H "Authorization: Bearer imf_sk_…" \
  https://app.immo-fluss.de/api/v1/status

# → { "tier": "prime", "dailyToolCallsUsed": 3, "dailyToolCallLimit": 300, ... }

Ausgabe anlegen (Pro / Ultra)

# POST – neue Ausgabe
curl -X POST https://app.immo-fluss.de/api/v1/expenses \
  -H "Authorization: Bearer imf_sk_…" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Rechnung Sanitär Müller",
    "amount": 149.99,
    "category": "Dienstleistung / Handwerker",
    "paymentDate": "2026-07-15"
  }'

Ausgaben eines Jahres filtern

curl -H "Authorization: Bearer imf_sk_…" \
  "https://app.immo-fluss.de/api/v1/expenses?year=2026&category=Grundsteuer"

Fehlercodes

Fehler kommen als JSON: { "error": "<code>", "message": "<Text>" }.

Status	Code	Bedeutung
`401`	unauthorized	Kein oder ungültiger API-Key / Token
`403`	upgrade_required	Schreiben ohne Pro/Ultra-Abo
`403`	insufficient_scope	Key hat den nötigen Scope nicht
`404`	not_found	Endpunkt oder Ressource existiert nicht
`422`	validation_error	Parameter fehlen oder sind ungültig (siehe `details`)
`429`	quota_exceeded	Tageskontingent erreicht
`500`	internal_error	Interner Fehler – bitte erneut versuchen

OpenAPI & SDKs

Die komplette, maschinenlesbare Referenz gibt es als OpenAPI-3.1-Dokument. Damit generierst Du Clients für nahezu jede Sprache oder importierst die API direkt in Postman, Insomnia oder Deine Automations-Tools:

https://app.immo-fluss.de/api/v1/openapi.json

💡

Kein Entwickler? Kein Problem. Über n8n, Zapier oder Make verbindest Du ImmoFluss ganz ohne Code – API-Key eintragen, Basis-URL setzen, loslegen.

Bereit für Deinen ersten Request?

Erstelle in wenigen Sekunden einen API-Key in der App und leg los.

API-Key erstellen

Die offene ImmoFluss API