# Get property by ID (v1)

> **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://api.casafari.com/api/v1/properties/search/{property_id}`

[Properties](/docs/properties) · [REST API](/docs/rest/properties). Send `Authorization: Bearer $CASAFARI_TOKEN`; see [how to get a token](/docs/rest#get-a-token).

Over MCP: no tool does this. See [MCP and REST compared](/docs/parity#properties).

## Description

Returns a property object.

## Path parameters

- `property_id` (string, required)

## Query parameters

- `limit` (integer, optional): Number of results to return per page.
- `offset` (integer, optional): Offset from which to start the search. Maximum value is 50000.

## Example request

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

```bash
curl "https://api.casafari.com/api/v1/properties/search/<property_id>" \
  -H "Authorization: Bearer $CASAFARI_TOKEN"
```

## Responses

### 200 OK

Type: `object[]`.

- `count` (integer, optional)
- `next` (string (uri), optional, nullable)
- `previous` (string (uri), optional, nullable)
- `results` (object, optional)
  - `property_id` (integer, required): ID of the property.
  - `primary_listing_id` (integer, required): Primary listing (ad) ID of the property which is defined after the matching into property.
  - `type` (string, required): Property type, as returned by the GET /api/v1/references/types endpoint. Values: `apartment`, `studio`, `duplex`, `penthouse`, `dachgeschosswohnung`, `etagenwohnung`, `erdgeschosswohnung`, `country_house`, `house`, `palace`, `townhouse`, `villa`, `country_estate`, `chalet`, `bungalow`, `family_house`, `reihenhaus`, `reihenendhaus`, `reihenmittelhaus`, `einfamilienhaus`, `zweifamilienhaus`, `landwirtschaftliche_betriebe`, `retail`, `office`, `industrial`, `warehouse`, `hotel`, `other_commercial`, `restaurant`, `werkstatt`, `plot`, `urban_plot`, `rural_plot`, `room`, `other`, `garage`, `parking`, `apartment_building`, `office_building`, `mix_use_building`.
  - `type_group` (string, required): Property type group, as returned by the GET /api/v1/references/types endpoint.
  - `operations` (string[], required): Operation types for which property is available. Values: `sale`, `rent`.
  - `location` (object, required): Information about property location.
    - `location_id` (integer, required): Location ID, as returned by the POST /api/v1/references/locations endpoint.
    - `name` (string, required): Location name.
    - `administrative_level` (string, required): Location administrative level.
    - `zip_codes` (string[], optional): The location zip codes. default [].
  - `locations_structure` (object[], required): Information about all the parent locations (including property location) up to the country.
    - `location_id` (integer, required): Location ID, as returned by the POST /api/v1/references/locations endpoint.
    - `name` (string, required): Location name.
    - `administrative_level` (string, required): Location administrative level.
    - `zip_codes` (string[], optional): The location zip codes. default [].
  - `coordinates` (object, required): Property coordinates.
    - `latitude` (number, required): Latitude.
    - `longitude` (number, required): Longitude.
  - `total_area` (integer, required): Total area.
  - `living_area` (integer, required): Living area.
  - `plot_area` (integer, required): Plot area.
  - `terrace_area` (integer, required): Terrace area.
  - `bathrooms` (integer, required): Number of bathrooms.
  - `bedrooms` (integer, required): Number of bedrooms.
  - `rooms` (integer, required): Number of rooms.
  - `number_of_parkings` (integer, optional, nullable): Number of parking spaces.
  - `floor_number` (integer, required): Exact floor number. Negative values indicate underground floors (e.g. basements).
  - `rent_currency` (string, required): Rent price currency code.
  - `rent_period` (string, required): Rent period. Values: `day`, `week`, `fortnight`, `month`, `year`, `none`.
  - `rent_price` (integer, required): Current rent price, in the currency of the listings (specified by the `rent_currency` field).
  - `rent_status` (string, required): Current rent status of the property. Values: `active`, `reserved`, `hold`, `rented`, `none`.
  - `sale_currency` (string, required): Sale price currency code.
  - `sale_price` (integer, required): Current sale price, in the currency of the listings (specified by the `sale_currency` field).
  - `sale_status` (string, required): Current sale status of the property. Values: `active`, `reserved`, `hold`, `sold`, `none`.
  - `is_private_property` (boolean, required): Whether the property is listed by a private individual, as opposed to an agent or a professional.
  - `features` (object, required): Property features, as returned by the GET /api/v1/references/features endpoint.
    - `floor` (string, required): Floor type. Values: `no_floor`, `ground`, `middle`, `top`.
    - `orientation` (string, required): Property view orientation. Values: `exterior`, `interior`.
    - `view` (string, required): View from the property. **This field is deprecated and will be removed in the next major update.** **Please, use `views` field instead.** Values: `water`, `landscape`, `city`, `golf`, `park`.
    - `views` (string[], required): List of views from the property. Values: `water`, `landscape`, `city`, `golf`, `park`.
    - `direction` (string, required): Cardinal direction the property faces. **This field is deprecated and will be removed in the next major update.** **Please, use `directions` field instead.** Values: `north`, `south`, `east`, `west`.
    - `directions` (string[], required): List of cardinal directions the property faces. Values: `north`, `south`, `east`, `west`.
    - `characteristics` (string[], required): Property characteristics. Values: `balcony`, `elevator`, `no_elevator`, `garage`, `garden`, `parking`, `storage`, `swimming_pool`, `terrace`, `rental_license`, `furniture`, `rented_out`, `life_annuity`.
  - `condition` (string, required): Property condition, as returned by the GET /api/v1/references/conditions endpoint. Values: `used`, `ruin`, `very-good`, `new`, `other`.
  - `sale_time_on_market` (object, required): Information about the property last activity on the sales market.
    - `date_start` (string (date), required): Start date of activity on the market.
    - `date_end` (string (date), required): End date of activity on the market.
    - `days_on_market` (integer, required): Number of days property was / is on the market.
    - `has_untracked_period` (boolean, required): Whether the property was already on the market when it started being tracked.
  - `rent_time_on_market` (object, required): Information about the property last activity on the rental market.
    - `date_start` (string (date), required): Start date of activity on the market.
    - `date_end` (string (date), required): End date of activity on the market.
    - `days_on_market` (integer, required): Number of days property was / is on the market.
    - `has_untracked_period` (boolean, required): Whether the property was already on the market when it started being tracked.
  - `listings` (object[], required): The list of listings related to the property.
    - `listing_id` (integer, required): ID of the listing (ad).
    - `total_area` (integer, required): Total area.
    - `plot_area` (integer, required): Plot area.
    - `terrace_area` (integer, required): Terrace area.
    - `bedrooms` (integer, required): Number of bedrooms.
    - `bathrooms` (integer, required): Number of bathrooms.
    - `rooms` (integer, required): Number of rooms.
    - `sale_status` (string, required): Current sale status of the listing. Values: `active`, `reserved`, `hold`, `sold`, `none`.
    - `sale_currency` (string, required): Sale price currency code.
    - `sale_price` (integer, required): Current sale price, in the currency of the listing (specified by the `sale_currency` field).
    - `sale_price_base` (integer, required): Current sale price, in Euros.
    - `rent_status` (string, required): Current rent status of the listing. Values: `active`, `reserved`, `hold`, `rented`, `none`.
    - `rent_currency` (string, required): Rent price currency code.
    - `rent_price` (integer, required): Current rent price, in the currency of the listing (specified by the `rent_currency` field).
    - `rent_price_base` (integer, required): Current rent price, in Euros.
    - `agency_legal_id` (string, required): Agency legal identifier specified on the source. Only for France and its overseas territories(DROM and COM).
    - `agency` (string, required): The company that manages the listing.
    - `listing_url` (string, optional, nullable): URL of the listing. Available only for currently active listings.
    - `listing_old_url` (string, optional, nullable): Old URL of the listing. Available only for currently inactive listings.
    - `description` (string, required): Property description.
    - `listing_uid` (string, required): Unique ID of the listing on the source site.
    - `construction_year` (integer, required): Construction year.
    - `source_name` (string, required): The name of the source where the listing is displayed.
    - `contacts_info` (object, required): Information about listing contacts.
      - `name` (string, required): The owner name. Only for FSBO listings.
      - `email` (string (email), required): The email contact.
      - `phone` (string, required): The phone contact.
    - `energy_certificate` (string, required): Energy certificate classification that attests to the energy efficiency of a property. **This field is deprecated and will be removed in the next major update.** **Please, use `energy_rating` field instead.**
    - `energy_rating` (string, required): Energy rating that attests to the energy efficiency of a property.
    - `heating_type` (string, required): Type of heating.
    - `ceiling_label` (string, required): Ceiling height in meters. Available only for Germany.
    - `commission` (number, required): Commission percentage. Available only for Germany.
    - `min_rent_area` (integer, required): Minimum rental area in square meters (mainly applicable to commercial properties). Available only for Germany.
    - `companies` (object[], required): Companies to which the listing belongs.
      - `name` (string, required): Company name.
      - `casafari_connect_on` (boolean, required): Whether the company is connected to Casafari Connect.
    - `created_at` (string (date), required): The datetime when the listing was added.
    - `floor_number` (integer, required): Exact floor number. Negative values indicate underground floors (e.g. basements).
    - `is_private` (boolean, required): Whether the listing is listed by a private individual, as opposed to an agent or a professional.
    - `casafari_connect` (boolean, required): Whether the company is connected to Casafari Connect.
    - `thumbnails` (string[], optional): List of the thumbnail image URLs.
    - `pictures` (string[], optional): List of the original picture image URLs.
    - `ref_numbers` (string[], optional): List of reference numbers.
    - `is_private_property` (boolean, required): Whether the listing is listed by a private individual, as opposed to an agent or a professional.
    - `is_auction_property` (boolean, required): Whether the listing is an auction property.
    - `is_bank_property` (boolean, required): Whether the listing is a bank property.
  - `history` (object[], optional): List of sale and rent price history data. **This field is deprecated and will be removed in the next major update.** **Please, use `sale_price_history and rent_price_history` field instead.** default [].
    - `sale_price` (integer, required): Sale price, in the currency of the listings (specified by the `sale_currency` field).
    - `sale_currency` (string, required): Sale price currency code.
    - `rent_price` (integer, required): Rent price, in the currency of the listings (specified by the `rent_currency` field).
    - `rent_currency` (string, required): Rent price currency code.
    - `changed_at` (string (date), required): Date when the estate was last updated.
  - `sale_price_history` (object[], optional): List of sale price history data. default [].
    - `date_start` (string (date), required): Start date when the change was applied.
    - `date_end` (string (date), required): End date when the change was applied.
    - `sale_price_old` (integer, required): Old sale price, in the currency of the listings.
    - `sale_price_new` (integer, required): New sale price, in the currency of the listings.
  - `rent_price_history` (object[], optional): List of rent price history data. default [].
    - `date_start` (string (date), required): Start date when the change was applied.
    - `date_end` (string (date), required): End date when the change was applied.
    - `rent_price_old` (integer, required): Old rent price, in the currency of the listings.
    - `rent_price_new` (integer, required): New rent price, in the currency of the listings.
  - `sale_status_history` (object[], optional): List of sale status history data. default [].
    - `date_start` (string (date), required): Start date when the change was applied.
    - `date_end` (string (date), required): End date when the change was applied.
    - `sale_status_old` (string, required): Old sale status, in the currency of the listings.
    - `sale_status_new` (string, required): New sale status, in the currency of the listings.
  - `rent_status_history` (object[], optional): List of rent status history data. default [].
    - `date_start` (string (date), required): Start date when the change was applied.
    - `date_end` (string (date), required): End date when the change was applied.
    - `rent_status_old` (string, required): Old rent status, in the currency of the listings.
    - `rent_status_new` (string, required): New rent status, in the currency of the listings.
  - `property_url` (string, optional, nullable): URL of the property in the CASAFARI website.
  - `address` (string, required): Property address.
  - `zip_code` (string, required): The location zip code.
  - `distance` (number, optional, nullable): Distance in kilometers from target point to the property.Available only when the `custom_location_boundary.circle` field is defined in the request.
  - `description` (string, required): Property description.
  - `construction_year` (integer, required): Construction year.
  - `rent_price_base` (integer, required): Current rent price, in Euros.
  - `rent_price_per_sqm` (number, required): Current rent price per square meter, in the currency of the listings (specified by the `rent_currency` field).
  - `rent_price_per_sqm_base` (number, required): Current rent price per square meter, in Euros.
  - `sale_price_base` (integer, required): Current sale price, in Euros.
  - `sale_price_per_sqm` (number, required): Current sale price per square meter, in the currency of the listings (specified by the `sale_currency` field).
  - `sale_price_per_sqm_base` (number, required): Current sale price per square meter, in Euros.
  - `is_auction_property` (boolean, required): Whether the property is an auction property.
  - `is_bank_property` (boolean, required): Whether the property is a bank property.
  - `changed_at` (string (date), required): The date and time when the property was last updated.
  - `sale_price_last_change` (object, required): Information about the last change of sale price.
    - `change_date` (string (date), required): Date of the change.
    - `old_value` (integer, required): Value before change.
    - `new_value` (integer, required): Value after change.
  - `rent_price_last_change` (object, required): Information about the last change of rent price.
    - `change_date` (string (date), required): Date of the change.
    - `old_value` (integer, required): Value before change.
    - `new_value` (integer, required): Value after change.
  - `thumbnails` (string[], optional): List of the thumbnail image URLs.
  - `pictures` (string[], optional): List of the original picture image URLs.
  - `gross_yield` (number, required): Gross yield in percentage.
  - `title` (string, required): Property title.
  - `energy_certificate` (string, required): Energy certificate classification that attests to the energy efficiency of a property. **This field is deprecated and will be removed in the next major update.** **Please, use `energy_rating` field instead.**
  - `energy_rating` (string, required): Energy rating that attests to the energy efficiency of a property.
  - `ceiling_label` (string, required): Ceiling height in meters. Available only for Germany.
  - `min_rent_area` (integer, required): Minimum rental area in square meters (mainly applicable to commercial properties). Available only for Germany.
  - `ref_numbers` (string[], optional): List of reference numbers from listings.
  - `casafari_connect` (boolean, required): Whether the company is connected to Casafari Connect.
  - `source_floor_numbers` (integer[], optional): List of property floor numbers based on listings data. Negative values indicate underground floors (e.g. basements). default [].
  - `retail_data` (object, optional, nullable): Retail-related attributes of the property. Null for non-commercial properties or if the retail data is not available.
    - `facade_measurements` (object, required): Facade measurements of the commercial property (height, length, surface in meters).
      - `height` (number, required): Facade height in meters.
      - `length` (number, required): Facade length in meters.
      - `surface` (number, required): Facade surface area in square meters.
    - `transfer_price_range` (object, required): Price range if the property is available for transfer.
      - `gte` (integer, required): Lower bound of the transfer price range.
      - `lte` (integer, required): Upper bound of the transfer price range.
    - `is_street_level` (boolean, required): Whether the commercial entrance is situated at the street level, without having to go upstairs/downstairs to reach it.
    - `number_of_floors` (integer, required): The number of commercial property floors.
    - `number_of_premises` (integer, required): The number of property usable rooms/premises.
    - `possible_business_types` (string[], required): What kind of business can/did run in this commercial property (e.g. cafe, restaurant, grocery store, dental clinic).

### 401 Unauthorized

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

### 403 Forbidden

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

### 404 Not Found

Type: `object`.

- `errors` (object, optional): Description of the errors encountered.

## Questions about this

- [Can I search properties over Casafari MCP?](/docs/faq/properties-over-mcp)
- [How do I look up one property and its price history?](/docs/faq/example-property-lookup)
- [Does Casafari keep price and status history?](/docs/faq/price-and-status-history)