Zum Hauptinhalt springen
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

inquiry.json
{
  "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.