---
title: "Überblick"
description: "Diese API führt Interessenten mit ihren Suchprofilen, nimmt Anfragen entgegen und bewertet, wie gut beides zu einem Objekt passt."
url: "https://maklerportal.apim.eu/apis/interessenten/docs/uebersicht"
image: "https://maklerportal.apim.eu/_og/d/c_Ocean.takumi,title_~w5xiZXJibGljaw,description_~RGllc2UgQVBJIGbDvGhydCBJbnRlcmVzc2VudGVuIG1pdCBpaHJlbiBTdWNocHJvZmlsZW4sIG5pbW10IEFuZnJhZ2VuIGVudGdlZ2VuIHVuZCBiZXdlcnRldCwgd2llIGd1dCBiZWlkZXMgenUgZWluZW0gT2JqZWt0IHBhc3N0Lg,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9hcGlzL2ludGVyZXNzZW50ZW4vZG9jcy91ZWJlcnNpY2h0Ig,s_4FFIxIMia36OIESk.png"
---

# Überblick

Diese API führt Interessenten mit ihren Suchprofilen, nimmt Anfragen entgegen und bewertet, wie gut beides zu einem Objekt passt.

## [Bewertung nachvollziehbar halten](#bewertung-nachvollziehbar-halten)

Jede Bewertung liefert nicht nur eine Punktzahl, sondern die einzelnen Kriterien mit ihrem Gewicht. Das ist Absicht: Wenn ein Interessent fragt, warum er keinen Besichtigungsplatz bekommen hat, können Sie es beantworten – und Sie erkennen selbst, wenn ein Kriterium wie `finanzierungsnachweis` systematisch die Liste verzerrt.

| Punkte | Einstufung |
| :----- | :--------- |
| 0–39   | niedrig    |
| 40–69  | mittel     |
| 70–100 | hoch       |

## [Datenschutz ist eingebaut](#datenschutz-ist-eingebaut)

Jeder Interessent trägt ein `aufbewahrung_bis`. Es wird beim Anlegen aus dem Sachverhalt abgeleitet und mit jeder Aktivität neu berechnet. Nach Ablauf werden Name, Anschrift und Kontaktdaten nächtlich entfernt; die statistischen Merkmale bleiben für Auswertungen erhalten.

Eine `einwilligung` ist Pflicht. Ohne sie lehnt die API das Anlegen mit `400` ab – bewusst, denn eine nachträglich beschaffte Einwilligung ist in der Praxis kaum je zu belegen.

Ein Löschverlangen setzen Sie über `POST /interessenten/{id}/loeschung` sofort um; es hat Vorrang vor jeder Frist.

## [Benötigte Scopes](#benötigte-scopes)

`interessenten:lesen` zum Abfragen, `interessenten:schreiben` zum Pflegen und Bewerten.