---
title: "List all estates"
method: GET
path: "/estates"
tags: ["Estates"]
---

# List all estates

`GET /estates`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/estates`
- Auth: HTTP bearer

Retrieve all estates for the authenticated tenant.

This endpoint returns all estates regardless of their associated place,
providing a flat view of all estates in the system.

**Note**: This is a flat route that complements the nested route `/places/{id}/estates`.
Use this endpoint when you need to access estates without knowing their parent place,
or when you need to change an estate's place association.

## Query parameters

- `search` string
- `name` string
- `address` string
- `fiscal_identifier` string
- `estate_type_id` string, uuid
- `rental_status` string
- `place_id` string, uuid
- `city` string
- `postal_code` string
- `rent_amount_min` number
- `rent_amount_max` number
- `area_min` number
- `area_max` number
- `number_of_rooms_min` integer
- `number_of_rooms_max` integer
- `owner_id` string, uuid
- `has_owner` boolean
- `archived` boolean
- `construction_date_after` string, date
- `construction_date_before` string, date
- `page` integer
- `limit` integer
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

OK

- Estate[]
  - `id` string, uuid, nullable
  - `name` string, nullable: Property name
  - `place_id` string, uuid, nullable
  - `estate_type_id` string, uuid, nullable
  - `area` number, nullable
  - `number_of_room` integer, nullable
  - `orientation` string, nullable
  - `building` string, nullable
  - `floor` integer, nullable
  - `owner_id` string, uuid, nullable
  - `previous_owner_id` string, uuid, nullable
  - `lot_number` string, nullable
  - `fiscal_identifier` string, nullable: Property tax identifier (required)
  - `housing_tax` number, nullable
  - `property_tax` number, nullable
  - `acquisition_price` number, nullable
  - `rent_amount` number, nullable: Reference rent amount for the property (in euros). Automatically synchronized with active leases.
  - `rental_status` 'VACANT' | 'RENTED' | 'NOTICE': Rental status of a property. - **VACANT**: Vacant property, no active lease - **RENTED**: Rented property, at least one active lease - **NOTICE**: Property under notice period, at least one lease under notice (without an active lease) This status is automatically synchronized with the status of associated leases when statuses change (ACTIVE, NOTICE, TERMINATED).
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable
  - `address` string, nullable
  - `other_detail` string, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)