Passer au contenu principal
WEBHOOK
property-notification
{
  "id": "11111111-2222-3333-4444-555555555555",
  "description": "Appartement refait à neuf avec vue dégagée.",
  "status": {
    "current": "available"
  },
  "classifieds": [
    {
      "id": "7f6e3b4d-9c22-46a0-8f20-0d1a2b3c4d5e",
      "status": {
        "current": "available"
      },
      "source": {
        "domain": "seloger.com",
        "url": "https://www.seloger.com/annonces/achat/appartement/paris-1er-75/5-pieces/0.htm"
      },
      "publisher": {
        "isProfessional": true,
        "type": "agency",
        "id": "2c2a42a0-1a9b-4b18-9f1d-1f9b2a3c4d5e",
        "email": "[email protected]",
        "phone": "+33123456789",
        "feesUrl": "https://www.agence-paris.fr/honoraires",
        "siren": "123456789",
        "siret": "12345678900011"
      },
      "transaction": {
        "current": 720000,
        "history": [
          {
            "id": "90f10d54-6d61-4b2a-a19c-12d962d9b0af",
            "value": 750000,
            "timestamp": "2025-05-15T10:00:00Z"
          },
          {
            "id": "2c1d5c25-9b3e-4f9e-a3db-5b8dd89f8cb3",
            "value": 720000,
            "timestamp": "2025-06-20T11:00:00Z"
          }
        ],
        "initial": 750000,
        "perSquareUnit": 12000
      }
    }
  ],
  "location": {
    "city": {
      "inseeCode": "75056",
      "name": "Paris"
    },
    "country": "france",
    "department": "75",
    "postcode": "75001",
    "latitude": 48.8606,
    "longitude": 2.3376
  },
  "media": {
    "images": [
      {
        "id": "5cd6da5c-6b9b-4d6d-9b35-4d5ecf921111",
        "position": 1,
        "url": "https://images.immoteur.com/sample/property-main.jpg"
      },
      {
        "id": "8fd4b645-d5e1-4c61-8f0a-4f86b3f21555",
        "position": 2,
        "url": "https://images.immoteur.com/sample/property-living.jpg"
      }
    ]
  },
  "meta": {
    "firstSeenAt": "2025-05-10T08:00:00Z",
    "lastSeenAt": "2025-06-20T11:00:00Z"
  },
  "property": {
    "type": "apartment",
    "area": 82.5,
    "bedroomCount": 3,
    "bathroomCount": 2,
    "terraceExists": true,
    "orientation": "south"
  },
  "transaction": {
    "type": "sale",
    "price": {
      "current": 720000,
      "history": [
        {
          "id": "90f10d54-6d61-4b2a-a19c-12d962d9b0af",
          "value": 750000,
          "timestamp": "2025-05-15T10:00:00Z"
        },
        {
          "id": "2c1d5c25-9b3e-4f9e-a3db-5b8dd89f8cb3",
          "value": 720000,
          "timestamp": "2025-06-20T11:00:00Z"
        }
      ],
      "initial": 750000,
      "perSquareUnit": 12000
    }
  },
  "energy": {
    "dpe": {
      "label": "c",
      "value": 125
    },
    "ges": {
      "label": "a",
      "value": 12
    }
  }
}

Autorisations

Authorization
string
header
requis

Send your Immoteur Personal Access Token in the Authorization header: Authorization: Bearer <token>

You can create and manage your Personal Access Tokens here: https://immoteur.com/dashboard/settings status: current: available

En-têtes

User-Agent
string
requis

Identifies the request as an Immoteur webhook call.

X-Immoteur-Service-Id
string<uuid>
requis

UUID of the Immoteur service emitting this webhook.

X-Immoteur-Event-Id
string<uuid>
requis

Correlation ID for the webhook payload.

X-Immoteur-Delivery-Id
string<uuid>
requis

Unique identifier for this HTTP delivery attempt.

X-Immoteur-Timestamp
string
requis

Unix timestamp (seconds) for the delivery attempt.

Corps

application/json
classifieds
object[]
requis

Classifieds currently associated with the property.

description
string | null
requis

Description of the property.

id
string<uuid>
requis

Unique identifier for the property.

Exemple:

"11111111-2222-3333-4444-555555555555"

location
object
requis

Location information for the property.

meta
object
requis
property
object
requis

Property information aggregated from classifieds.

status
object
requis

Current lifecycle status of the property, aggregated from classifieds.

transaction
object
requis

Transaction information for the property.

energy
object

Energy information aggregated from the property's classifieds.

media
object

Media information aggregated from classifieds.

Réponse

Webhook received successfully