Lease Management

Copy page

Lease Management Overview

Understand the lease lifecycle — from draft creation to signature, rent revisions, amendments, and termination.

Lease lifecycle

Code
 
Draft → Active → InRevision → Active → ... → Terminated
  │                                              │
  └──► Cancelled                                 └──► Archived

Status	Description
Draft	Lease created, not yet signed. Can be edited freely.
Active	Lease signed and in effect. Rent is due.
InRevision	Annual rent revision in progress (IRL index).
Terminated	Lease ended (notice given, end of term, or mutual agreement).
Cancelled	Draft lease cancelled before signature.
Archived	Terminated lease moved to archive.

Creating a lease

A lease connects an estate (the rental unit) with a lease type (the legal framework) and defines the rental terms.

Prerequisites

1. A place with at least one estate
2. An owner linked to the place
3. A lease type (e.g., unfurnished residential, furnished, commercial)

Create the lease

Code
 
curl -X POST https://api.faireplace.com/api/leases \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "estate_id": "<estate_uuid>",
    "lease_type_id": "<lease_type_uuid>",
    "start_date": "2026-04-01",
    "end_date": "2029-03-31",
    "rent_amount": 950.00,
    "rent_frequency": "Monthly",
    "deposit_amount": 950.00,
    "revision_index_type": "IRL",
    "usage_type": "MainResidence",
    "payment_day": 5,
    "payment_terms": "InAdvance",
    "payment_method": "BankTransfer",
    "charge_settlement_mode": "Provision"
  }'

Add tenants

Code
 
# 1. Create the tenant
curl -X POST https://api.faireplace.com/api/lessees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Marie", "last_name": "Martin", "category": "individual"}'

# 2. Associate with the lease
curl -X POST https://api.faireplace.com/api/leases/{lease_id}/lessees \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"lessee_id": "<lessee_uuid>", "role": "PrimaryTenant", "start_date": "2026-04-01"}'

Key lease fields

Field	Description
rent_amount	Monthly rent excluding charges (loyer hors charges)
deposit_amount	Security deposit. Max 1 month for unfurnished, 2 for furnished.
charge_settlement_mode	Provision (estimated + annual settlement) or Forfeit (fixed amount)
revision_index_type	IRL for residential — determines annual rent revision
reference_rent_per_m2	Reference rent from legislative zone (encadrement des loyers)
is_subject_to_rent_evolution_decree	Whether rent evolution decree applies
is_subject_to_reference_rent_cap	Whether rent cap applies in this zone

Compliance checks

When creating or updating a lease, FairePlace validates:

• Rent cap: If the estate is in a zone with rent control, the rent must not exceed reference_rent_increased_per_m2 × area
• Deposit limit: Maximum 1 month rent for unfurnished, 2 months for furnished
• Lease duration: Minimum 3 years for unfurnished, 1 year for furnished, 1-10 months for student mobility
• Required fields: All fields mandated by French law (Loi Alur) are checked

PDF generation

Generate the formatted lease document from the lease data:

Code
 
curl -X POST https://api.faireplace.com/api/leases/{lease_id}/pdf \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"template_type": "StandardLease", "include_tenant_info": true}'

See Documents & PDFs for details on document generation.

Electronic signature

Once the PDF is generated, initiate the signature process:

Code
 
curl -X POST https://api.faireplace.com/api/leases/{lease_id}/signature/initiate \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pdf_id": "<pdf_uuid>", "signers": [...]}'

See Electronic Signatures for the full workflow.

Charges

Charges are recurring costs associated with the lease (utilities, maintenance, etc.):

Code
 
curl -X POST https://api.faireplace.com/api/leases/{lease_id}/charges \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "charge_type": "WaterCold",
    "amount": 35.00,
    "frequency": "Monthly",
    "settlement_mode": "Provision"
  }'

See Charges API for all charge types and settlement modes.

---

Related

• Leases API — Full endpoint reference
• Lease Types — Legal frameworks
• Charges API — Manage lease charges
• Documents & PDFs — PDF generation
• Amendments — Modify active leases
• Lease Workflow — End-to-end tutorial