Lessees
Leases

List the leases of a tenant

Returns every lease this tenant is attached to: the landlord's view, scoped to the calling organisation.

Do not confuse it with /lessee/leases: that one is the tenant portal and resolves the tenant from the connected tenant's own JWT. Here the tenant is named in the path, and the caller is the landlord.

get/lessees/{id}/leases

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/lessees/{id}/leases
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Tenant (lessee) id.

Response

OK

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

status'DRAFT' | 'PENDING_SIGNATURE' | 'ACTIVE' | 'NOTICE' | 'FINALISATION' | 'TERMINATED' | 'EXPIRED' required

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'VIREMENT_BANCAIRE' | 'PRELEVEMENT_AUTOMATIQUE' | 'CHEQUE' | 'ESPECES' | 'CARTE_BANCAIRE' | 'MANDAT_CASH' | 'AUTRE' required

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'formation_professionnelle' | 'etudes_superieures' | 'contrat_apprentissage' | 'stage' | 'service_civique' | 'mutation_professionnelle' | 'mission_temporaire' | 'autre' nullable

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.