# Get one premises

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

`GET https://platform.casafari.com/v1/claro/premises/{id}`

[Claro AI](/docs/claro) · [REST API](/docs/claro#rest-api). Send `Authorization: Bearer $CASAFARI_API_KEY`: a platform API key or OAuth access token, metered in platform units; see [platform sign-in](/docs/rest#platform-api-keys) and [Claro AI](/docs/claro#keys). 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`](/docs/claro/get_premises) (equivalent). See [MCP and REST compared](/docs/parity#claro-ai).

## 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

- `id` (string, required)

## Query parameters

- `insights` (string, optional): 1 adds `insights`: the page's charts as data. Values: `1`.
- `segments` (string, optional): Comma-separated business kinds to list first in the distances chart, e.g. burger,coffee.
- `assessment` (string, optional): With insights=1: 1 adds `site_assessment` first in `insights` (see the get_premises tool's `assessment`). Values: `1`.

## Example request

Placeholders only: replace the token and the values with your own.

```bash
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`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 401 Missing or invalid key

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 403 No access

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 429 Rate limited

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

## Related pages

- [Search commercial premises (POST /v1/search)](/docs/rest/claro/search-premises)
- [Refine a search (POST /v1/search/refine)](/docs/rest/claro/refine-search)
- [Compare premises (POST /v1/compare)](/docs/rest/claro/compare-premises)
- [Location figures (POST /v1/location)](/docs/rest/claro/explain-location)
- [Claro AI: all its MCP tools and REST operations](/docs/claro)
- [Connect Claro to an MCP client](/docs/claro/connect)
- [MCP vs REST API compared](/docs/parity)