---
title: "Create estate for place"
method: POST
path: "/places/{id}/estates"
tags: ["Estates"]
---

# Create estate for place

`POST /places/{id}/estates`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/places/{id}/estates`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- CreateEstate
  - `owner_id` string, uuid, required: Owner this estate belongs to. Required.
  - `name` string, required: Property name
  - `estate_type_id` string, uuid, required
  - `area` number, required
  - `number_of_room` integer, nullable
  - `orientation` string, nullable
  - `building` string, nullable
  - `floor` integer, nullable
  - `lot_number` string, nullable
  - `fiscal_identifier` string: 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). Used as default value when creating 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

## Response `201`

Created

- 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

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Bad request
- `500`: Bad request

---

[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)