High Potential Seller Leads · REST API
Get a seller lead
GET
https://platform.casafari.com/v1/seller-leads/{lead_id}API key10 units1 parameter
Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token; see platform sign-in. Costs 10 units (1 unit = EUR 0.04).
Over MCP: none; this product is REST only.
Description
One lead by its lead_ id: the home, with the same fields as GET /v1/property-sourcing/properties/{property_id}, and its dated price and status history. 10 units.
Path parameters
lead_idstringrequiredA
lead_ id from GET /v1/seller-leads.Example request
Placeholders only: replace the token and the values with your own.
curl "https://platform.casafari.com/v1/seller-leads/lead_5Tn3wK8pR2yH6mQ1vX9cBe" \
-H "Authorization: Bearer $CASAFARI_API_KEY"Responses
200 The lead.
Type: object.
Show the response shape (11 fields)
idstringpropertyanyhistoryobject[]8 properties
datestringnullableeventstringnullableWhat changed, e.g. a new listing, a price change, a status change.
actionstringnullableoperationstringnullableold_valueanyThe value before the change.
new_valueanyThe value after the change.
sourcestringnullableagencystringnullableExample with sample values (ids and figures are illustrative) (long arrays shortened)
{
"id": "lead_5Tn3wK8pR2yH6mQ1vX9cBe",
"property": {
"id": "prop_9Rk4tW2nP7xM3cL6vB1qZs",
"type": "apartment",
"operation": "sale",
"price": {
"amount": 350000,
"currency": "EUR",
"per_sqm": 4375
},
"bedrooms": 2,
"living_area_sqm": 80,
"location": {
"id": 12345,
"name": "Sample district",
"coordinates": {
"lat": 40.4172,
"lon": -3.7051
}
},
"first_seen": "2026-03-02",
"listings_count": null,
"matched_tags": null,
"bathrooms": 1,
"total_area_sqm": 86,
"plot_area_sqm": null,
"construction_year": 1965,
"energy_rating": null,
"condition": "good",
"features": [
"elevator"
],
"address": null,
"description": "Sample description.",
"status": "active"
},
"history": [
{
"date": "2026-03-02",
"event": "new",
"action": null,
"operation": "sale",
"old_value": null,
"new_value": 400000,
"source": "Sample agency website",
"agency": "Sample agency"
},
{
"date": "2026-05-11",
"event": "price_change",
"action": "decrease",
"operation": "sale",
"old_value": 400000,
"new_value": 375000,
"source": "Sample agency website",
"agency": "Sample agency"
}
]
}401 Missing or unknown API key or token.
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring402 No units left to fund the call (`payment_required`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring403 The account is not entitled to this lead's country (`not_entitled`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring404 No lead has this id (`not_found`).
Type: object.
Show the response shape (10 fields)
typestringThe problem's documentation URL.
titlestringstatusintegerdetailstringWhat happened and how to fix it.
instancestringcodestringe.g. invalid_request, payment_required, not_entitled, not_found, page_depth_exceeded, request_limit_reached.
request_idstringerrorsobject[]One entry per field to fix.
2 properties
fieldstringmessagestring