Property Management

Copy page

Property Management Overview

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

Property hierarchy

Code
 
Place (building/site)
 └── Estate (apartment/unit)
      └── Room (individual room)
           └── Equipment (appliances, fixtures)

Every rental property follows this hierarchy:

Level	Resource	Description
Place	/api/places	A building, house, or property site. Contains address, legislative zone, and owner.
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	Fixtures and appliances — water heater, radiators, oven. Documented in the lease.

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 legislative zone — determines rent control and compliance rules

Code
 
curl -X POST https://api.faireplace.com/api/places \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Residence Les Jardins",
    "type_id": "<place_type_uuid>",
    "legislative_zone_id": "<zone_uuid>",
    "owner_id": "<owner_uuid>",
    "address_line1": "24 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 $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "estate_type_id": "<estate_type_uuid>",
    "area": 45.0,
    "number_of_room": 2,
    "floor": 3,
    "description": "T2 with balcony, 3rd floor"
  }'

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 $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"room_type_id": "<room_type_uuid>", "area": 18.5, "name": "Sejour"}'

4. Add Equipment

Equipment items are documented in the lease for furnished rentals.

Code
 
curl -X POST https://api.faireplace.com/api/places/<place_id>/estates/<estate_id>/equipment \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Chauffe-eau", "brand": "Atlantic", "condition": "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
ASL	Free syndicate association
AFUL	Urban land association

Legislative zones

Every place must be linked to a legislative zone. These zones determine:

• 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 Legislative Zones for the full zone 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 — Track fixtures and appliances
• Keys — Key lifecycle management
• Legislative Zones — Zone compliance