Skip to main content
Rolling outAs of November 19, 2026

Inquiries as JSON by email

Each inquiry as one email to the address you give us. The email body is the JSON, and your software reads it in.

The email

One email per new inquiry, plain UTF-8 text, the whole text is one JSON object. It goes to the address you give us for your listings. The subject is “Homematch Anfrage” followed by the inquiryId, and Reply-To is the inquirer. Follow-up messages do not arrive as JSON.

Reply directly

The email and phone number of the person asking are real, so your agency can reply directly.

Fields

versionstring
Always "1". We’ll announce any new version.
sourcestring
Always "homematch".
inquiryIdstring
Unique identifier of the inquiry. If it arrives twice, it’s the same one.
sentAtstring
When the inquiry was sent (ISO 8601).
listing.providerReferencestring | null
Your own property reference from your feed.
listing.homematchListingIdstring
The listing’s number on Homematch.
listing.urlstring
The link to the listing.
listing.addressstring | null
The property’s address, on one line.
inquirer.firstNamestring | null
First name.
inquirer.lastNamestring | null
Last name.
inquirer.emailstring
Email of the person asking.
inquirer.phonestring | null
Phone, if given.
inquirer.languagestring
The person’s language: de, fr, it or en.
messagestring
The message, as written.
profileobject | null
The applicant profile, if the person sends one.
profile.dealstring
rent or sale.
profile.topicsstring[]
What the profile contains, never the details themselves.
conversationUrlstring | null
Always null by email: reply to the person directly at their address.

What topics can name

Only the kind of detail, never the value:

  • household
  • pets
  • employment
  • income
  • moveIn
  • purchasePurpose
  • equity
  • financing

Example

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
}

Ready to test?

We’ll give you access to our test environment and check your integration before it goes live.