Copy page

Lease Management

Lease Management Overview

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

Lease lifecycle

Code
DRAFT → PENDING_SIGNATURE → ACTIVE → NOTICE → FINALISATION → TERMINATED → EXPIRED

Status	Description
DRAFT	Lease created, not yet signed. Can be edited freely.
PENDING_SIGNATURE	Lease sent for electronic signature.
ACTIVE	Lease signed and in effect. Rent is due.
NOTICE	Notice period in progress (tenant or landlord gave notice).
FINALISATION	End-of-lease finalisation (exit inspection, deposit settlement, charge regularisation).
TERMINATED	Lease ended. Can be archived after 90 days.
EXPIRED	Lease term has expired. Can be archived.

Post-Active transitions (NOTICE → FINALISATION → TERMINATED) are managed exclusively through the Termination API. The generic PUT /leases/{id}/status only handles pre-Active transitions.

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 $API_KEY" \
  -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": "RESIDENTIAL_ONLY",
    "payment_day": 5,
    "payment_terms": "TERME_A_ECHOIR",
    "payment_method": "VIREMENT_BANCAIRE",
    "charge_settlement_mode": "PROVISION"
  }'

Add tenants

Code
# 1. Create the tenant
curl -X POST https://api.faireplace.com/api/lessees \
  -H "Authorization: Bearer $API_KEY" \
  -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 $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lessee_id": "<lessee_uuid>", "role_type": "PRIMARY", "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), PERIODIC (periodic billing), or FLAT_RATE (fixed amount)
revision_index_type	IRL for residential — determines annual rent revision
reference_rent_per_m2	Reference rent for the property's area (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 $API_KEY" \
  -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 $API_KEY" \
  -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 $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_place_id": "<service_uuid>",
    "category_id": "<category_uuid>",
    "calculation_method": "PROVISION",
    "calculation_basis": "FORFAIT",
    "amount": 35.00,
    "billing_period_start": "2026-04-01",
    "billing_period_end": "2027-03-31"
  }'

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
• Termination & Archival — End-of-lease workflow (notice, finalisation, deposit, archive)
• Lease Workflow — End-to-end tutorial