Security Deposits
Leases

Record a security deposit

Record the collection of a security deposit for a lease.

Only one deposit is allowed per lease. If a deposit already exists, returns a business error.

The deposit amount should match the deposit_amount field on the lease, which is validated against French legal limits per lease type:

  • Residential empty: max 1 month rent
  • Furnished/student: max 2 months rent
  • Commercial: max 3 months rent
  • Mobility lease: deposit forbidden (Art. 25-13 ALUR)

Permissions required: leases:write

post/leases/{lease_id}/deposit

Request

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

Path parameters

lease_idstring uuid required

Lease ID

Request body

amountnumber required

Deposit amount

paid_datestring date nullable

Date the deposit was collected

Example request

{
  "amount": 750,
  "paid_date": "2026-01-15"
}

Response

Deposit recorded successfully

idstring uuid required
lease_idstring uuid required
amountnumber required

Deposit amount collected

paid_datestring date nullable

Date the deposit was collected

statusstring required

Current status (COLLECTED, PENDING_RETURN, PARTIALLY_RETURNED, FULLY_RETURNED, DISPUTED)

restitution_due_datestring date nullable

Deadline for restitution (1 or 2 months after lease end)

restitution_datestring date nullable

Actual date the deposit was returned

amount_returnednumber nullable

Amount returned to the tenant

retained_for_chargesnumber nullable

Amount retained for co-ownership charge provisions (max 20% per Art. 22)

retained_for_damagesnumber nullable

Amount retained for property damages

retained_for_unpaid_rentnumber nullable

Amount retained for unpaid rent

penalty_amountnumber nullable

Late return penalty (10% of monthly rent HC per month of delay)

exit_inspection_conformityboolean required

Whether the exit inspection was conformity-compliant (affects restitution deadline)

copro_accounts_approval_datestring date nullable

Date of syndic account approval (triggers release of retained charges)

notesstring nullable

Additional notes

Example response

{
  "amount": 750,
  "paid_date": "2026-01-15",
  "status": "COLLECTED",
  "exit_inspection_conformity": true
}

Changes

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