Bewertung

Vier Bewertungswerkzeuge. Unterstützt werden Wohnungen, Häuser und Grundstücke; Express-Bewertung und Gutachten lehnen Gewerbeimmobilien und Wohnanlagen mit 422 business_rule ab; die Mietschätzung funktioniert auch für Gewerbeimmobilien.

Express-Bewertung

POST /valuation/express - Bereich tools:valuation, sofort. Ein API-Aufruf plus der Preis der Express-Bewertung.

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5b8c3f7e-2a71-4c55-8d0e-9f1a6b2c4d10" \
  -d '{"propertyCategory":"apartment","addressText":"Torstraße 12, Berlin","totalArea":64,"rooms":2,"currency":"EUR"}'

Antwort:

Ohne Fläche oder mit unbekannter propertyCategory - 400 validation; Gewerbeimmobilien - 422 business_rule mit code: commercial_unsupported.

Vollständiger Bewertungsbericht

POST /valuation/report - Bereich tools:valuation, Auftrag. Ein Bericht mit Marktanalyse und PDF. Die Pflichtfelder hängen von propertyCategory ab. Senden Sie nur die Felder Ihrer Kategorie: Ein Feld einer anderen Kategorie (zum Beispiel houseLevels bei einer Wohnung, parking bei einem Haus) wird mit 400 abgelehnt. Nur Wohnung: livingArea, kitchenArea, bathrooms, ceilingHeight, floor, storeys, balcony, elevator, parking, houseType, apartmentType. Nur Haus: houseLevels. Nur Grundstück: zoning. Haus und Grundstück: utilities.

curl -X POST https://developers.grem.capital/api/v1/valuation/report \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "propertyCategory": "apartment",
    "address": { "country": "Germany", "city": "Berlin", "street": "Torstraße", "streetNumber": "12" },
    "currency": "EUR", "language": "eng",
    "apartmentType": "Residential", "houseType": "panel",
    "totalArea": 64, "rooms": 2, "floor": 3, "storeys": 5,
    "balcony": true, "elevator": false, "condition": "good"
  }'

Antwort 202: { "jobId": "...", "status": "processing", "state": "running" }. Der fertige Auftrag (GET /valuation/report/jobs/{id}) enthält:

Gewerbeimmobilien (auch apartmentType Commercial oder Industrial) werden mit 422 business_rule und code: commercial_unsupported abgelehnt - ihre Miete schätzt POST /valuation/rent. Ein Wohnkomplex (apartmentType: Complex) - 422 mit code: complex_unsupported: Bewerten Sie eine einzelne Wohnung oder ein Haus darin.

PDF: GET /artifacts/v1/ai/appraisal/reports/{id}/pdf. Ereignisse - valuation.completed / valuation.failed.

Mietbewertung

POST /valuation/rent - Bereich tools:rent, sofort. Beschreiben Sie die Immobilie mit Feldern oder übergeben Sie die objectId eines eigenen oder öffentlichen Objekts.

curl -X POST https://developers.grem.capital/api/v1/valuation/rent \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","country":"Germany","city":"Berlin","totalArea":50,"rooms":2,"currency":"EUR"}'

Antwort:

Ohne Fläche oder Stadt - 400 mit einem detail wie "Missing or invalid: totalArea".

Berichtsprüfung

POST /valuation/review - Bereich tools:review. Laden Sie einen Bewertungsbericht hoch (PDF, DOCX, DOC, RTF; bis 40 MB) - GREM liest ihn und prüft den Wert an Marktdaten.

Body - multipart/form-data:

curl -X POST https://developers.grem.capital/api/v1/valuation/review \
  -H "Authorization: Bearer gsk_live_xxx" \
  -F "[email protected]" \
  -F "language=eng" -F "currency=EUR"

Das Dokument wird sofort gelesen. Die 202-Antwort enthält jobId, status und state:

• action_required (status: need_confirm) - extracted enthält die aus dem Dokument gelesenen Daten. Prüfen und bestätigen Sie: POST /valuation/review/jobs/{id}/confirm (Aufträge und Ergebnisse). Nach der Bestätigung wechselt der Auftrag zu running.
• failed (status: rejected) - das Dokument ist kein Immobilienbewertungsbericht.

Das fertige Ergebnis - GET /valuation/review/jobs/{id}; der Prüfbericht - GET /artifacts/v1/ai/appraisal/reviews/{id}/report.pdf oder report.docx. Ereignisse - review.completed / review.failed; die Webhook-Verfolgung beginnt nach der Bestätigung.

Verwandte Artikel

• Aufträge und Ergebnisse
• Fehler
• Limits und Abrechnung