Lessees
Leases
Signatures

List leases pending signature for the tenant

Retrieves the list of leases where the user is a tenant and where a signature is pending on their part.

Filtering criteria

  • The lease must have an initiated signature document
  • The document status must not be COMPLETED
  • There must be a signature request of type TENANT with a non-COMPLETED status

Required permissions

  • lessee:leases:read
get/lessee/leases/pending-signatures

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/lessee/leases/pending-signatures
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of contracts to return.

offsetinteger

Number of contracts to skip.

Response

Leases pending signature list

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.