Get one plot (Germany)
https://platform.casafari.com/v1/claro/plots/{id}Send Authorization: Bearer $CASAFARI_API_KEY: a platform API key or OAuth access token, metered in platform units; see platform sign-in and Claro AI. On the platform this is GET https://platform.casafari.com/v1/claro/plots/{id}; GET /v1/plots/{id} is Claro's own path, which the platform adds /claro to. The platform forwards the call to Claro unchanged: Claro's Claro-Version header and its error bodies ({"error":{"code","message"}}, with rate_limited and quota_reached on a 429) pass through.
Over MCP: get_plot (equivalent). MCP and REST compared.
Description
One plot in full by the id search_plots returned: its data, commercial-use level, the facts read from its text with the quote each came from (fact_sources), an excerpt, the agency's link and the other agencies advertising it (also_listed_by).
Published summary: Get one plot
Path parameters
idstringrequiredExample request
Placeholders only: replace the token and the values with your own.
curl "https://platform.casafari.com/v1/claro/plots/<id>" \
-H "Authorization: Bearer $CASAFARI_API_KEY"Responses
200 Get one plot
No body.
Example from the API description
{
"id": "pm_Qw7rT2xLmN8bV4cZ1aYs0e",
"title": "Gewerbegrundstück im Gewerbegebiet Nord",
"plot_type": "building_plot",
"country": "de",
"region": "Bayern",
"municipality": "Ingolstadt",
"zipcode": "85055",
"location_precision": "approximate",
"coordinates": {
"lat": 48.79,
"lon": 11.45,
"precision": "approximate"
},
"for_sale": true,
"for_rent": false,
"sale_eur": 1200000,
"rent_eur_month": null,
"plot_area_m2": 6000,
"sale_eur_per_m2": 200,
"commercial_use": {
"level": "zoned_commercial",
"meaning": "The plot's text states a commercial zoning class: GE, GI, MK or MU (Gewerbe-, Industrie-, Kerngebiet, urbanes Gebiet).",
"evidence": "Das Grundstück liegt im Gewerbegebiet (GE)",
"facts_read": true
},
"facts_from_text": {
"zoning_class": "GE",
"serviced": true
},
"excerpt": "Voll erschlossenes Gewerbegrundstück, ca. 6.000 m², direkte Anbindung an die A9.",
"agency": {
"name": "Muster Immobilien",
"listing_url": "https://muster-immobilien.de/expose/1"
},
"agency_links": [
{
"name": "Muster Immobilien",
"listing_url": "https://muster-immobilien.de/expose/1"
}
],
"fact_sources": {
"zoning_class": "Das Grundstück liegt im Gewerbegebiet (GE)",
"serviced": "voll erschlossen"
}
}400 Invalid request
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired401 Missing or invalid key
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired403 No access
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired429 Rate limited
Type: object.
Show the response shape (3 fields)
errorobject2 properties
codestringrequiredmessagestringrequired