Copy page

Property Management

Property Management Overview

Understand how buildings, apartments, rooms, and equipment are organized in the FairePlace API.

Property hierarchy

Code
Place (building/site)
 ├── Service (chargeable building services — heating, elevator, water)
 ├── Equipment ← can be attached at any level
 └── Estate (apartment/unit)
      ├── Equipment ← can be attached at any level
      └── Room (individual room)
           ├── Equipment (fixed installations — for État des Lieux)
           └── Inventory (moveable items — for furnished lease inventory, rooms only)

Every rental property follows this hierarchy:

Level	Resource	Description
Place	/api/places	A building, house, or property site. Contains address, country, and owner.
Service	/api/places/{id}/services	A chargeable building service — heating, elevator, water supply. Links to distribution keys.
Estate	/api/places/{id}/estates	A rentable unit — apartment, studio, commercial space. Has area, floor, room count.
Room	/api/places/{id}/estates/{id}/rooms	Interior rooms — living room, bedroom, kitchen, bathroom. Used in lease documents.
Equipment	/api/places/{id}/estates/{id}/equipment	Fixed installations — radiators, doors, plumbing. Used in the État des Lieux.
Inventory	/api/inventory/items	Moveable items — furniture, appliances. Used in the Inventaire Mobilier for furnished leases.

Equipment vs Inventory

These are two distinct concepts that serve different legal documents:

	Equipment	Inventory
Purpose	Track fixed/permanent installations for the État des Lieux (property inspection report)	Track moveable/furnished items for the Inventaire Mobilier (furnished lease inventory)
Required for	All lease types	Furnished leases only (bail meublé)
Typical items	Radiators, doors, windows, plumbing, electrical outlets, shutters	Bed, table, sofa, refrigerator, washing machine, cookware, bedding
Legal basis	Decree 2016-382 (État des Lieux)	Decree 2015-981 (mandatory furnished items list)
Condition tracking	Status + notes (structured)	Status + notes + financial value + maintenance history
Scope	Attachable to rooms, estates, or places	Attached to rooms only (via room inventory)

In short: If it's "in the walls" → Equipment. If you can move it out → Inventory.

How it works

1. Create a Place

A place is always the top-level container. It requires:

• An owner (individual or SCI company)
• A place type (apartment building, house, commercial building, etc.)
• A country — determines which rent regulation and compliance rules apply

Code
curl -X POST https://api.faireplace.com/api/places \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Residence Les Jardins",
    "type_id": "<place_type_uuid>",
    "country_id": "<zone_uuid>",
    "owner_id": "<owner_uuid>",
    "country": "France",
    "street_number": "24",
    "street_name": "rue du Faubourg Saint-Antoine",
    "postal_code": "75012",
    "city": "Paris",
    "place_category": "Collective",
    "legal_regime": "Copropriete"
  }'

2. Add Estates

Each estate is a rentable unit within the place. An apartment building with 10 apartments has 10 estates.

Code
curl -X POST https://api.faireplace.com/api/places/<place_id>/estates \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "T2 - Apt 301",
    "estate_type_id": "<estate_type_uuid>",
    "area": 45.0,
    "fiscal_identifier": "75012-B-0301",
    "number_of_room": 2,
    "floor": 3
  }'

3. Define Rooms

Rooms describe the interior layout. This information appears on the lease document and is required by French rental law.

Code
curl -X POST https://api.faireplace.com/api/places/<place_id>/estates/<estate_id>/rooms \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type_room_id": "<room_type_uuid>", "carrez_surface": 18.5, "habitable_surface": 18.5, "designation": "Sejour"}'

4. Add Equipment (fixed installations)

Equipment tracks fixed installations with their condition for the État des Lieux.

Code
curl -X POST https://api.faireplace.com/api/rooms/<room_id>/equipment \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "equipment_id": "<equipment_type_uuid>",
    "quantity": 1,
    "condition_status": "GOOD",
    "condition_notes": "Fonctionnel, légères traces d usure"
  }'

5. Add Inventory (furnished leases only)

For furnished leases, inventory tracks all moveable items required by Decree 2015-981.

Code
curl -X POST https://api.faireplace.com/api/places/<place_id>/estates/<estate_id>/rooms/<room_id>/inventory \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "inventory_id": "<inventory_item_uuid>",
    "quantity_in_room": 1,
    "condition_in_room": "GOOD"
  }'

Place categories

Category	Description
Individual	Single-unit property (house, villa)
Collective	Multi-unit building (apartment complex)

Legal regimes

Regime	Description
Copropriete	Co-ownership (most apartment buildings)
MonoPropriete	Sole ownership

Countries

Every place must be linked to a country. The country determines:

• Whether rent control (encadrement des loyers) applies
• Reference rents per m² for the area
• Whether the property is in a zone tendue (high-demand area)
• Notice period requirements

See Rent Regulation & Rent Control for the full reference.

Types

Place types, estate types, and room types are predefined resources:

Code
# Get all place types
GET /api/types/places

# Get all estate types
GET /api/types/estates

# Get all room types
GET /api/types/rooms

See the API Reference for available type values.

---

Related

• Places API — Full endpoint reference for places
• Estates API — Manage rental units
• Rooms API — Define room layouts
• Equipment API — Fixed installations and condition tracking (État des Lieux)
• Inventory API — Moveable items for furnished leases (Inventaire Mobilier)
• Services API — Chargeable building services (heating, elevator, water)
• Keys — Key lifecycle management
• Rent Regulation & Rent Control — Country-level compliance