# Lease Management Overview

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

## Lease lifecycle

```
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](/leases/lease-termination). 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](/properties/places) with at least one [estate](/properties/estates)
2. An [owner](/people/owners) linked to the place
3. A [lease type](/leases/lease-types) (e.g., unfurnished residential, furnished, commercial)

### Create the lease

```bash
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

```bash
# 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:

```bash
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](/leases/documents-and-pdfs) for details on document generation.

## Electronic signature

Once the PDF is generated, initiate the signature process:

```bash
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](/signatures/overview) for the full workflow.

## Charges

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

```bash
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](/leases/charges) for all charge types and settlement modes.

---

## Related

- **[Leases API](/leases/leases)** — Full endpoint reference
- **[Lease Types](/leases/lease-types)** — Legal frameworks
- **[Charges API](/leases/charges)** — Manage lease charges
- **[Documents & PDFs](/leases/documents-and-pdfs)** — PDF generation
- **[Amendments](/leases/amendments)** — Modify active leases
- **[Termination & Archival](/leases/lease-termination)** — End-of-lease workflow (notice, finalisation, deposit, archive)
- **[Lease Workflow](/signatures/lease-workflow)** — End-to-end tutorial