Get one premises
https://platform.casafari.com/v1/claro/premises/{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/premises/{id}; GET /v1/premises/{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_premises (equivalent). MCP and REST compared.
Description
One premises in full by the id a search returned: its data, facts read from its text with the sentence each came from (fact_sources), its coordinates (exact, or approximate: snapped to a ~500 m cell), location figures (with location access), an excerpt, up to 8 photos (photos: Casafari thumbnail URLs; search results carry the first 4, and photo_source names the advertiser and page they come from), and the agency's own listing link (agency_links lists every agency's own page for the premises, never a portal's, earliest first). energy is the energy certificate as the ad advertises it, unverified: not checked against the official register (rating and emissions rating A to G, kWh/m² and kg CO2/m² a year, each null when not stated; null until read); energy.official is the regional register's certificate, only when it is matched on this unit and declares commercial use, with the register and the attribution its licence asks for (else null). status says whether it is still on the market. timeline gives when it was first listed (listed_since, days_listed) and, per live operation, the first and current asking price, the number of price cuts, the change in percent and the asking-price periods (history); null fields are not stated.
Path parameters
idstringrequiredQuery parameters
insightsstringinsights: the page's charts as data.1segmentsstringassessmentstringsite_assessment first in insights (see the get_premises tool's assessment).1Example request
Placeholders only: replace the token and the values with your own.
curl "https://platform.casafari.com/v1/claro/premises/<id>" \
-H "Authorization: Bearer $CASAFARI_API_KEY"Responses
200 Get one premises
No body.
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