API Dokumentation

REST API v1 für Verwalter-Integrationen

Authentication

Alle API-Requests benötigen einen API-Key im Header:

X-API-Key: vv_your_api_key_here

API-Keys können im Verwalter-Dashboard unter Einstellungen generiert werden.

Rate Limits

Standard: 1000 Requests pro Stunde
Burst: 100 Requests pro Minute

Bei Überschreitung: HTTP 429 (Too Many Requests)

Endpoints

GET/api/v1/leads

Ruft alle freigeschalteten Leads ab

{
  "leads": [
    {
      "id": "uuid",
      "status": "unlocked",
      "auftrag": {
        "propertyType": "weg",
        "unitCount": 24,
        "city": "Berlin",
        "zip": "10115",
        "description": "..."
      },
      "createdAt": "2026-02-06T..."
    }
  ],
  "meta": {
    "total": 8
  }
}

GET/api/v1/profile

Ruft eigenes Verwalter-Profil ab

POST/api/v1/messages

Sendet Nachricht an Eigentümer

POST/api/v1/webhooks/configure

Konfiguriert Webhook für Events

Events:

lead.unlocked - Neuer Lead freigeschaltet
message.received - Neue Nachricht erhalten
review.posted - Neue Bewertung

Support

Bei Fragen zur API: api@verwalter-vermittlung.de