Look Up Property History
lookup_property_historyGet transaction history for a specific address - essential for due diligence.
REQUIRED: One of these combinations:
address + code_postal: "49 cours Richard Vitton" → sales at that number (one building). Without a number ("cours Richard Vitton") → the 50 most recent sales on the whole street. Full street types (cours, avenue, boulevard…) and bis/ter are understood.
section + no_plan + code_commune: Cadastral parcel lookup
Returns:
Transactions, newest first (max 50), with scope = address | street | parcel
Each transaction includes an id field — pass it to get_building_characteristics for BDNB building data
Price, surface, type, rooms, buyer type for each
price_evolution: only for a repeat sale of the same property (same type, surface within 5%), otherwise null
No sale at the number: the numbers on that street that do have sales
Workflow: lookup_property_history → use transaction id → get_building_characteristics
Example by address: {address: "49 cours Richard Vitton", code_postal: "69003"}
Example by cadastral: {section: "AB", no_plan: "123", code_commune: "101"}
Cost: 20 credits per call, refunded when nothing is found
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | No | Street address to search | |
| no_plan | No | Cadastral plan number | |
| section | No | Cadastral section | |
| code_postal | No | Postal code (required with address) | |
| code_commune | No | DVF commune code — NOT the full 5-digit INSEE code. Strip the 2-digit department prefix and any leading zeros. Examples: Paris 16e → '116', Paris 1er → '101', Lyon 6e → '386', Nice → '88', Bordeaux → '63'. |