In EinführungStand 19. November 2026
Anfragen als JSON per E-Mail
Jede Anfrage als eine E-Mail an die Adresse, die du uns gibst. Der Text der E-Mail ist das JSON, deine Software liest es ein.
Die E-Mail
Eine E-Mail pro neuer Anfrage, Klartext in UTF-8, der ganze Text ist ein JSON-Objekt. Sie geht an die Adresse, die du uns für deine Inserate nennst. Der Betreff lautet «Homematch Anfrage» und die inquiryId, Reply-To ist die anfragende Person. Folgenachrichten kommen nicht als JSON.
Direkt antworten
E-Mail und Telefon der anfragenden Person sind echt, damit deine Agentur direkt antworten kann.
Felder
versionstring- Immer "1". Eine neue Version kündigen wir an.
sourcestring- Immer "homematch".
inquiryIdstring- Eindeutige Kennung der Anfrage. Kommt sie zweimal, ist es dieselbe.
sentAtstring- Wann die Anfrage gesendet wurde (ISO 8601).
listing.providerReferencestring | null- Deine eigene Objektreferenz aus deinem Feed.
listing.homematchListingIdstring- Die Nummer des Inserats auf Homematch.
listing.urlstring- Der Link zum Inserat.
listing.addressstring | null- Die Adresse des Objekts, eine Zeile.
inquirer.firstNamestring | null- Vorname.
inquirer.lastNamestring | null- Nachname.
inquirer.emailstring- E-Mail der anfragenden Person.
inquirer.phonestring | null- Telefon, falls angegeben.
inquirer.languagestring- Sprache der Person: de, fr, it oder en.
messagestring- Die Nachricht, wie sie geschrieben wurde.
profileobject | null- Das Bewerbungsprofil, falls die Person eines mitschickt.
profile.dealstring- rent oder sale.
profile.topicsstring[]- Welche Angaben das Profil enthält, nie die Angaben selbst.
conversationUrlstring | null- Bei E-Mail immer null: Antworte der Person direkt an ihre Adresse.
Was topics nennen kann
Nur die Art der Angabe, nie den Wert:
- household
- pets
- employment
- income
- moveIn
- purchasePurpose
- equity
- financing
Beispiel
{
"version": "1",
"source": "homematch",
"inquiryId": "7d0f3c2a5b1e4c8d9f6a2e4b8c1d0a93",
"sentAt": "2026-11-19T13:32:05Z",
"listing": {
"providerReference": "R-1234",
"homematchListingId": "1234567",
"url": "https://homematch.ch/listings/1234567",
"address": "Musterstrasse 12, 8000 Zürich"
},
"inquirer": {
"firstName": "Anna",
"lastName": "Muster",
"email": "anna.muster@example.invalid",
"phone": "+41 79 000 00 00",
"language": "de"
},
"message": "Guten Tag, ist die Wohnung noch frei? Ich würde sie gerne besichtigen.",
"profile": {
"deal": "rent",
"topics": [
"household",
"employment",
"income",
"moveIn"
]
},
"conversationUrl": null
}Bereit zum Testen?
Wir geben dir Zugang zu unserer Testumgebung und prüfen deine Anbindung, bevor sie live geht.