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