Aller au contenu principal
En déploiementÉtat au 19 novembre 2026

Demandes en JSON par e-mail

Chaque demande arrive dans un e-mail à l’adresse que tu nous donnes. Le texte de l’e-mail est le JSON, ton logiciel le lit.

L’e-mail

Un e-mail par nouvelle demande, en texte brut UTF-8, dont tout le texte est un objet JSON. Il part à l’adresse que tu nous indiques pour tes annonces. L’objet est « Homematch Anfrage » suivi de l’inquiryId, et le Reply-To est la personne qui demande. Les messages suivants n’arrivent pas en JSON.

Répondre directement

L’e-mail et le téléphone de la personne sont réels, pour que ton agence puisse répondre directement.

Champs

versionstring
Toujours "1". Nous annoncerons toute nouvelle version.
sourcestring
Toujours "homematch".
inquiryIdstring
Identifiant unique de la demande. S’il arrive deux fois, c’est la même demande.
sentAtstring
Quand la demande a été envoyée (ISO 8601).
listing.providerReferencestring | null
Ta propre référence d’objet, issue de ton flux.
listing.homematchListingIdstring
Le numéro de l’annonce sur Homematch.
listing.urlstring
Le lien vers l’annonce.
listing.addressstring | null
L’adresse de l’objet, sur une ligne.
inquirer.firstNamestring | null
Prénom.
inquirer.lastNamestring | null
Nom.
inquirer.emailstring
E-mail de la personne qui fait la demande.
inquirer.phonestring | null
Téléphone, si indiqué.
inquirer.languagestring
Langue de la personne : de, fr, it ou en.
messagestring
Le message, tel qu’il a été écrit.
profileobject | null
Le profil de candidature, si la personne en joint un.
profile.dealstring
rent ou sale.
profile.topicsstring[]
Quelles informations le profil contient, jamais les informations elles-mêmes.
conversationUrlstring | null
Toujours null par e-mail : réponds directement à l’adresse de la personne.

Ce que topics peut indiquer

Seulement le type d’information, jamais la valeur :

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

Exemple

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
}

Prêt à tester ?

Nous te donnons accès à notre environnement de test et vérifions ta connexion avant sa mise en ligne.