Leases

Update lease

Update the information of an existing lease.

Automatic rent synchronization with Estate:

┌─────────────────────────────────────────────────────────────┐
│  Lease update (PUT /leases/{id})                             │
└─────────────────────────────────────────────────────────────┘
                      │
                      ▼
            ┌─────────────────────┐
            │ rent_amount provided │
            │ in the DTO?          │
            └─────────────────────┘
             │              │
    YES      │              │      NO
             ▼              ▼
┌──────────────────┐  ┌──────────────────┐
│ Update the lease │  │ No               │
│ with the new     │  │ synchronization  │
│ value            │  │ (rent_amount     │
│                  │  │ unchanged)       │
│ Synchronize      │  │                  │
│ with Estate      │  │                  │
│ (update)         │  │                  │
└──────────────────┘  └──────────────────┘

If rent_amount is provided in the update DTO, it automatically updates the rent_amount of the associated Estate
This synchronization ensures consistency between the lease rent and the property's reference rent
The synchronization is performed atomically during the lease update

put/leases/{lease_id}

Request

Base URL: https://api.faireplace.com/api
URL: https://api.faireplace.com/api/leases/{lease_id}
Auth: HTTP bearer

Path parameters

lease_idstring uuid required

Lease ID

Request body

reference_numberstring nullable

end_datestring date nullable

rent_amountnumber nullable

Rent amount.

Synchronization with Estate:

┌─────────────────────────────────────────────────────────────┐
│  Lease rent_amount update                                   │
└─────────────────────────────────────────────────────────────┘
                      │
                      ▼
            ┌─────────────────────┐
            │ rent_amount provided │
            │ in the DTO?         │
            └─────────────────────┘
             │              │
    YES      │              │      NO
             ▼              ▼
┌──────────────────┐  ┌──────────────────┐
│ Update the lease │  │ No               │
│ with the new     │  │ modification     │
│ value            │  │ (rent_amount     │
│                  │  │ unchanged)       │
│                  │  │                  │
│ Synchronize      │  │                  │
│ with Estate      │  │                  │
│ (update)         │  │                  │
└──────────────────┘  └──────────────────┘

If this field is provided during the update, it automatically updates the rent_amount of the associated Estate
This synchronization maintains consistency between the lease rent and the property's reference rent
Synchronization is performed atomically during the lease update

deposit_amountnumber nullable

revision_index_type'ILC' | 'ILAT' | 'IRL' | 'ICC' | 'NONE'

Rent revision index type

next_revision_datestring date nullable

usage_type'RESIDENTIAL_ONLY' | 'MIXED_PROFESSIONAL'

Premises usage type

furniture_list_idstring uuid nullable

notesstring nullable

is_subject_to_rent_evolution_decreeboolean nullable

is_subject_to_reference_rent_capboolean nullable

reference_rent_per_m2number nullable

reference_rent_increased_per_m2number nullable

base_rent_amountnumber nullable

rent_complement_amountnumber nullable

rent_complement_justificationstring nullable

previous_tenant_last_rentnumber nullable

previous_tenant_last_payment_datestring date nullable

previous_tenant_last_revision_datestring date nullable

rent_revision_datestring date nullable

irl_reference_quarterstring nullable

irl_reference_valuenumber nullable

rent_regulation_zone_typestring nullable

rent_regulation_compliance_statusstring nullable

charge_settlement_mode'PROVISION' | 'PERIODIC' | 'FLAT_RATE'

Charge settlement mode

payment_dayinteger nullable

payment_terms'TERME_ECHU' | 'TERME_A_ECHOIR'

Payment terms

Payment method

tenant_fees_cap_visit_dossier_lease_per_m2number nullable

Cap for visit/dossier/lease fees per m² (tenant)

tenant_fees_cap_inventory_per_m2number nullable

Cap for inventory fees per m² (tenant)

landlord_fees_visit_dossier_leasenumber nullable

Landlord fees for visit/dossier/lease

landlord_fees_visit_dossier_lease_descriptionstring nullable

landlord_fees_inventory_entrynumber nullable

Landlord fees for inventory entry

landlord_fees_inventory_entry_descriptionstring nullable

landlord_fees_othernumber nullable

Other landlord fees

landlord_fees_other_descriptionstring nullable

tenant_fees_visit_dossier_leasenumber nullable

Tenant fees for visit/dossier/lease

tenant_fees_visit_dossier_lease_descriptionstring nullable

tenant_fees_inventory_entrynumber nullable

Tenant fees for inventory entry

tenant_fees_inventory_entry_descriptionstring nullable

tenant_fees_othernumber nullable

tenant_fees_other_descriptionstring nullable

fees_calculation_datestring date-time nullable

fees_regulation_complianceboolean nullable

fees_agency_namestring nullable

fees_agency_registration_numberstring nullable

student_school_namestring nullable

Educational institution name (student lease only)

student_enrollment_yearstring nullable

Academic year (student lease only)

student_certificate_providedboolean nullable

Enrollment certificate provided (student lease only)

student_levelstring nullable

Education level (student lease only)

Mobility reason (mobility lease only)

mobility_reason_otherstring nullable

Reason details if 'autre' (mobility lease only)

initial_duration_monthsinteger nullable

Initial duration in months (mobility lease only, between 1 and 10 months)

extended_duration_monthsinteger nullable

Duration after extension in months (mobility lease only, maximum 10 months total)

seasonal_rental_purposestring nullable

Seasonal stay reason (seasonal lease only, max duration 90 days). Common values: vacation, business trip, spa treatment, tourism, other.

seasonal_purpose_detailsstring nullable

Additional reason details if 'other' selected (seasonal lease only)

seasonal_guest_countinteger nullable

Number of guests accommodated in the property (seasonal lease only, minimum 1 person)

seasonal_cleaning_includedboolean nullable

Indicates whether end-of-stay cleaning is included in the rent (seasonal lease only)

seasonal_cleaning_feenumber nullable

End-of-stay cleaning fee if not included in the rent (seasonal lease only, in EUR)

seasonal_tourist_tax_includedboolean nullable

Indicates whether the tourist tax is included in the rent (seasonal lease only)

seasonal_tourist_tax_amountnumber nullable

Tourist tax amount per person per night (seasonal lease only, in EUR)

seasonal_services_includedstring nullable

Services included in the seasonal rental (wifi, household linen, parking, etc.)

seasonal_energy_mode'inclus_forfait' | 'compteur_releve' | 'non_inclus' nullable

Energy billing mode for the seasonal rental

seasonal_cancellation_policystring nullable

Specific cancellation policy defined by the landlord (conditions, deadlines, potential penalties)

seasonal_declaration_numberstring nullable

City hall declaration number (Cerfa n°14004) - Legally required unless the property is the landlord's primary residence (Tourism Code L.324-1-1)

commercial_business_namestring nullable

Tenant company business name (commercial lease only, required per Article L145-1)

commercial_legal_formstring nullable

Company legal form (SARL, SAS, EURL, etc.)

commercial_siretstring nullable

14-digit SIRET number (required for commercial lease, validated by CHECK constraint in database)

commercial_rcsstring nullable

RCS registration (e.g., RCS Paris 123 456 789)

commercial_activitystring nullable

Description of the authorized commercial activity (premises purpose, Article L145-1). Determines despecialization rights.

commercial_activity_code_apestring nullable

APE/NAF activity code (e.g., 47.11F)

commercial_triennial_exit_year_3string date nullable

Notification deadline for triennial termination at year 3 (3-6-9 rule, Article L145-5)

commercial_triennial_exit_year_6string date nullable

Notification deadline for triennial termination at year 6 (3-6-9 rule, Article L145-5)

commercial_triennial_exit_year_9string date nullable

Notification deadline for triennial termination at year 9 (3-6-9 rule, Article L145-5)

commercial_notice_period_monthsinteger nullable

Termination notice period in months (minimum 6 months per Article L145-12)

commercial_ilc_base_valuenumber nullable

Commercial Rent Index (ILC) reference value at lease start (for triennial revision)

commercial_ilc_base_datestring date nullable

ILC reference date (quarter) (e.g., 2024-10-01 for Q4 2024)

commercial_next_revision_datestring date nullable

Next triennial rent revision date based on ILC

commercial_rent_ceiling_enabledboolean nullable

Rent variation capping at +/-10% per 3-year period (Article L145-38)

commercial_insurance_policystring nullable

Insurance policy number for rental risks and professional liability (required per Article L145-7)

Example request

{
  "rent_amount": 1200,
  "revision_index_type": "IRL",
  "usage_type": "RESIDENTIAL_ONLY",
  "charge_settlement_mode": "PROVISION",
  "payment_terms": "TERME_A_ECHOIR",
  "payment_method": "VIREMENT_BANCAIRE",
  "student_school_name": "Université Paris-Saclay",
  "student_enrollment_year": "2024-2025",
  "student_level": "Master 1",
  "mobility_reason": "mission_temporaire",
  "initial_duration_months": 6,
  "extended_duration_months": 9,
  "seasonal_rental_purpose": "vacances",
  "seasonal_guest_count": 4,
  "seasonal_cleaning_fee": 80,
  "seasonal_tourist_tax_amount": 2.5,
  "seasonal_services_included": "WiFi, household linen, private parking",
  "seasonal_energy_mode": "inclus_forfait",
  "seasonal_declaration_number": "75001-2025-00123",
  "commercial_business_name": "TECH RETAIL SARL",
  "commercial_legal_form": "SARL",
  "commercial_siret": "12345678901234",
  "commercial_rcs": "RCS Paris 987 654 321",
  "commercial_activity": "IT retail and office equipment",
  "commercial_activity_code_ape": "47.11F",
  "commercial_triennial_exit_year_3": "2027-07-01",
  "commercial_triennial_exit_year_6": "2030-07-01",
  "commercial_triennial_exit_year_9": "2033-07-01",
  "commercial_notice_period_months": 6,
  "commercial_ilc_base_value": 130.52,
  "commercial_ilc_base_date": "2024-10-01",
  "commercial_next_revision_date": "2027-01-01",
  "commercial_insurance_policy": "POL-RC-2025-789456"
}

Response

Lease updated successfully

idstring uuid required

Unique lease identifier

estate_idstring uuid required

Rented property unit ID

lease_type_idstring uuid required

Lease type ID

template_idstring uuid nullable

Template ID used to generate the lease

agent_idstring uuid nullable

Agent ID (real estate agent)

reference_numberstring nullable

Lease reference number

Lease status

versioninteger required

Lease version (incremented with each amendment)

start_datestring date required

Lease start date

end_datestring date nullable

Lease end date

rent_amountnumber required

Lease rent amount (in EUR). Automatically synchronized with the associated Estate's rent_amount.

rent_frequency'MONTHLY' | 'QUARTERLY' | 'ANNUALLY' required

Rent payment frequency

deposit_amountnumber nullable

Security deposit amount

revision_index_type'ILC' | 'ILAT' | 'IRL' | 'ICC' | 'NONE'

Rent revision index type

last_revision_datestring date nullable

Date of the last rent revision

next_revision_datestring date nullable

Date of the next rent revision

usage_type'RESIDENTIAL_ONLY' | 'MIXED_PROFESSIONAL'

Premises usage type

furniture_list_idstring uuid nullable

Furniture list ID (for furnished leases)

notesstring nullable

Internal notes

is_subject_to_rent_evolution_decreeboolean required

Subject to rent evolution decree at re-letting

is_subject_to_reference_rent_capboolean required

Subject to increased reference rent by prefectural decree

reference_rent_per_m2number nullable

Reference rent in EUR/m²

reference_rent_increased_per_m2number nullable

Increased reference rent in EUR/m²

base_rent_amountnumber nullable

Base rent (equal to increased reference rent if supplement)

rent_complement_amountnumber nullable

Rent supplement

rent_complement_justificationstring nullable

Rent supplement justification

previous_tenant_last_rentnumber nullable

Previous tenant's last rent

previous_tenant_last_payment_datestring date nullable

Previous tenant's last payment date

previous_tenant_last_revision_datestring date nullable

Previous tenant's last revision date

rent_revision_datestring date nullable

Rent revision date

irl_reference_quarterstring nullable

IRL reference quarter (e.g., Q1 2024)

irl_reference_valuenumber nullable

IRL reference index value

rent_regulation_applied_atstring date-time nullable

Regulation application date

rent_regulation_zone_typestring nullable

Regulation zone type

rent_regulation_compliance_statusstring nullable

Regulation compliance status

rent_regulation_last_checkstring date-time nullable

Date of last compliance check

charge_settlement_mode'PROVISION' | 'PERIODIC' | 'FLAT_RATE'

Charge settlement mode

payment_dayinteger required

Monthly payment day (1-31)

payment_terms'TERME_ECHU' | 'TERME_A_ECHOIR' required

Payment terms

Payment method

rent_increase_for_worknumber nullable

Rent increase amount due to landlord's work

rent_increase_work_descriptionstring nullable

Description of work done by the landlord

rent_increase_work_costnumber nullable

Total cost of work done by the landlord

rent_increase_work_completion_datestring date nullable

Work completion date

rent_increase_legal_basisstring nullable

Legal basis (e.g., art. 17-2 law 1989)

rent_increase_calculation_methodstring nullable

Calculation method used

rent_increase_supporting_documentsobject nullable

Supporting documents (invoices, quotes) - JSON format

rent_increase_start_datestring date nullable

Start date of the rent increase application

rent_increase_end_datestring date nullable

End date of the rent increase application

rent_increase_duration_monthsinteger nullable

Application duration in months

rent_decrease_for_tenant_worknumber nullable

Rent decrease amount due to tenant's required work

rent_decrease_work_descriptionstring nullable

Description of work to be done by the tenant

rent_decrease_work_estimated_costnumber nullable

Estimated cost of work to be borne by the tenant

rent_decrease_work_deadlinestring date nullable

Deadline to complete the work

rent_decrease_work_specificationsstring nullable

Technical specifications of the work

rent_decrease_work_authorization_requiredboolean nullable

Prior authorization required

rent_decrease_restitution_clausestring nullable

Restitution clause at end of lease

rent_decrease_supporting_documentsobject nullable

Documents (quotes, specifications) - JSON format

rent_decrease_start_datestring date nullable

Start date of the rent decrease application

rent_decrease_end_datestring date nullable

End date of the rent decrease application

rent_decrease_duration_monthsinteger nullable

Application duration in months

solidarity_clausestring nullable

Solidarity clause between co-tenants

termination_clausestring nullable

Termination clause (termination conditions)

visit_clausestring nullable

Clause for visits to re-let or sell

furniture_provision_clausestring nullable

Clause regarding provided furniture

pet_clausestring nullable

Pet clause

insurance_clausestring nullable

Tenant home insurance clause

maintenance_clausestring nullable

Annual appliance maintenance clause

damage_clausestring nullable

Tenant damage clause

regularization_waiver_clausestring nullable

Charge regularization waiver clause

rent_free_clausestring nullable

Rent-free clause

custom_clausestring nullable

Custom clause (free-form)

rent_free_start_datestring date nullable

Rent-free period start date

rent_free_end_datestring date nullable

Rent-free period end date

rent_free_amountnumber nullable

Rent-free amount (0 = fully free, >0 = reduced rent)

tenant_fees_cap_visit_dossier_lease_per_m2number nullable

Fee cap for visits/file processing/lease drafting (EUR/m²)

tenant_fees_cap_inventory_per_m2number nullable

Fee cap for move-in inspection (EUR/m²)

landlord_fees_visit_dossier_leasenumber nullable

Fees for visits/file processing/lease drafting

landlord_fees_visit_dossier_lease_descriptionstring nullable

Details of services performed

landlord_fees_inventory_entrynumber nullable

Move-in inspection fees

landlord_fees_inventory_entry_descriptionstring nullable

Move-in inspection service details

landlord_fees_othernumber nullable

Other services

landlord_fees_other_descriptionstring nullable

Details of other services and conditions

tenant_fees_visit_dossier_leasenumber nullable

Fees for visits/file processing/lease drafting

tenant_fees_visit_dossier_lease_descriptionstring nullable

Details of services performed

tenant_fees_inventory_entrynumber nullable

Move-in inspection fees

tenant_fees_inventory_entry_descriptionstring nullable

Move-in inspection service details

tenant_fees_othernumber nullable

Other fees

tenant_fees_other_descriptionstring nullable

Details of other services

fees_calculation_datestring date-time nullable

Fee calculation date

fees_regulation_complianceboolean nullable

Regulatory compliance

fees_agency_namestring nullable

Agency/professional name

fees_agency_registration_numberstring nullable

Professional registration number

student_school_namestring nullable

Educational institution name (student lease only)

student_enrollment_yearstring nullable

Academic year (student lease only)

student_certificate_providedboolean nullable

Enrollment certificate provided (student lease only)

student_levelstring nullable

Education level (student lease only)

Mobility reason (mobility lease only)

mobility_reason_otherstring nullable

Reason details if 'autre' (mobility lease only)

initial_duration_monthsinteger nullable

Initial duration in months (mobility lease only, between 1 and 10 months)

extended_duration_monthsinteger nullable

Duration after extension in months (mobility lease only, maximum 10 months total)

seasonal_rental_purposestring nullable

Seasonal stay reason (seasonal lease only, max duration 90 days). Common values: vacation, business trip, spa treatment, tourism, other.

seasonal_purpose_detailsstring nullable

Additional reason details if 'other' selected (seasonal lease only)

seasonal_guest_countinteger nullable

Number of guests accommodated in the property (seasonal lease only, minimum 1 person)

seasonal_cleaning_includedboolean nullable

Indicates whether end-of-stay cleaning is included in the rent (seasonal lease only)

seasonal_cleaning_feenumber nullable

End-of-stay cleaning fee if not included in the rent (seasonal lease only, in EUR)

seasonal_tourist_tax_includedboolean nullable

Indicates whether the tourist tax is included in the rent (seasonal lease only)

seasonal_tourist_tax_amountnumber nullable

Tourist tax amount per person per night (seasonal lease only, in EUR)

seasonal_services_includedstring nullable

Services included in the seasonal rental (wifi, household linen, parking, etc.)

seasonal_energy_mode'inclus_forfait' | 'compteur_releve' | 'non_inclus' nullable

Energy billing mode for the seasonal rental

seasonal_cancellation_policystring nullable

Specific cancellation policy defined by the landlord (conditions, deadlines, potential penalties)

seasonal_declaration_numberstring nullable

City hall declaration number (Cerfa n°14004) - Legally required unless the property is the landlord's primary residence (Tourism Code L.324-1-1)

commercial_business_namestring nullable

Tenant company business name (commercial lease only, required per Article L145-1)

commercial_legal_formstring nullable

Company legal form (SARL, SAS, EURL, etc.)

commercial_siretstring nullable

14-digit SIRET number (required for commercial lease)

commercial_rcsstring nullable

RCS registration (e.g., RCS Paris 123 456 789)

commercial_activitystring nullable

Description of the authorized commercial activity (premises purpose, Article L145-1). Determines despecialization rights.

commercial_activity_code_apestring nullable

APE/NAF activity code (e.g., 47.11F)

commercial_triennial_exit_year_3string date nullable

Notification deadline for triennial termination at year 3 (3-6-9 rule, Article L145-5). The tenant must notify 6 months before this date.

commercial_triennial_exit_year_6string date nullable

Notification deadline for triennial termination at year 6 (3-6-9 rule, Article L145-5)

commercial_triennial_exit_year_9string date nullable

Notification deadline for triennial termination at year 9 (3-6-9 rule, Article L145-5)

commercial_notice_period_monthsinteger nullable

Termination notice period in months (minimum 6 months per Article L145-12)

commercial_ilc_base_valuenumber nullable

Commercial Rent Index (ILC) reference value at lease start (for triennial revision per Articles L145-33 to L145-38)

commercial_ilc_base_datestring date nullable

ILC reference date (quarter) (e.g., 2024-10-01 for Q4 2024)

commercial_next_revision_datestring date nullable

Next triennial rent revision date based on ILC

commercial_rent_ceiling_enabledboolean nullable

Rent variation capping at +/-10% per 3-year period (Article L145-38)

commercial_insurance_policystring nullable

Insurance policy number for rental risks and professional liability (required per Article L145-7)

created_atstring date-time required

Creation date

updated_atstring date-time required

Last modification date

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "estate_id": "550e8400-e29b-41d4-a716-446655440001",
  "lease_type_id": "550e8400-e29b-41d4-a716-446655440002",
  "reference_number": "BAIL-2024-001",
  "status": "ACTIVE",
  "version": 1,
  "start_date": "2024-01-01",
  "end_date": "2025-01-01",
  "rent_amount": 1200,
  "rent_frequency": "MONTHLY",
  "deposit_amount": 1200,
  "revision_index_type": "IRL",
  "usage_type": "RESIDENTIAL_ONLY",
  "reference_rent_per_m2": 20.5,
  "reference_rent_increased_per_m2": 22.55,
  "base_rent_amount": 1000,
  "rent_complement_amount": 200,
  "previous_tenant_last_rent": 1150,
  "irl_reference_quarter": "T1 2024",
  "irl_reference_value": 142.35,
  "charge_settlement_mode": "PROVISION",
  "payment_day": 5,
  "payment_terms": "TERME_A_ECHOIR",
  "payment_method": "VIREMENT_BANCAIRE",
  "student_school_name": "Université Paris-Saclay",
  "student_enrollment_year": "2024-2025",
  "student_level": "Master 1",
  "mobility_reason": "mission_temporaire",
  "initial_duration_months": 6,
  "extended_duration_months": 9,
  "seasonal_rental_purpose": "vacances",
  "seasonal_guest_count": 4,
  "seasonal_cleaning_fee": 80,
  "seasonal_tourist_tax_amount": 2.5,
  "seasonal_services_included": "WiFi, household linen, private parking",
  "seasonal_energy_mode": "inclus_forfait",
  "seasonal_declaration_number": "75001-2025-00123",
  "commercial_business_name": "TECH RETAIL SARL",
  "commercial_legal_form": "SARL",
  "commercial_siret": "12345678901234",
  "commercial_rcs": "RCS Paris 987 654 321",
  "commercial_activity": "IT retail and office equipment",
  "commercial_activity_code_ape": "47.11F",
  "commercial_triennial_exit_year_3": "2027-07-01",
  "commercial_triennial_exit_year_6": "2030-07-01",
  "commercial_triennial_exit_year_9": "2033-07-01",
  "commercial_notice_period_months": 6,
  "commercial_ilc_base_value": 130.52,
  "commercial_ilc_base_date": "2024-10-01",
  "commercial_next_revision_date": "2027-01-01",
  "commercial_despecialization_partial": [
    {
      "date": "2025-06-01",
      "activity": "Sale of IT accessories",
      "approved_by": "Jean Dupont"
    }
  ],
  "commercial_despecialization_full": {
    "date": "2026-03-15",
    "old_activity": "IT retail",
    "new_activity": "Restaurant",
    "approved": true,
    "indemnity_amount": 15000
  },
  "commercial_guarantors": [
    {
      "name": "Holding Company XYZ",
      "siret": "98765432109876",
      "address": "10 Avenue des Champs-Élysées, 75008 Paris",
      "guaranteed_amount": 50000,
      "signature_date": "2025-01-01"
    }
  ],
  "commercial_insurance_policy": "POL-RC-2025-789456",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.