Security Deposits

Security deposit (dépôt de garantie) management.

Per Art. 22 of Loi 89-462:

Restitution within 1 month (conformity) or 2 months (non-conformity) after lease end
Maximum 20% retention for co-ownership charge provisions
Late penalty: 10% of monthly rent (HC) per month of delay
One deposit per lease (unique constraint)

Get security deposit details

GET

https://api.faireplace.com/api

/leases/{lease_id}/deposit

Retrieve the security deposit details for a lease.

Returns the full deposit information including status, amounts retained, restitution dates, and any late penalties.

Permissions required: leases:read

Get security deposit details › path Parameters

lease_id

string · uuid · required

Lease ID

Get security deposit details › Responses

Security deposit details

A security deposit (dépôt de garantie) attached to a lease. Per Art. 22 of Loi 89-462: - Restitution within 1 month (conformity exit inspection) or 2 months (non-conformity) - Maximum retention of 20% for co-ownership charge provisions - Penalty: 10% of monthly rent (HC) per month of delay

SecurityDeposit

id

string · uuid · required

lease_id

string · uuid · required

amount

number · decimal · required

Deposit amount collected

Example: 750

status

string · required

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

Example: COLLECTED

exit_inspection_conformity

boolean · required

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

Example: true

paid_date

string | null · date

Date the deposit was collected

Example: 2026-01-15

restitution_due_date

string | null · date

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

restitution_date

string | null · date

Actual date the deposit was returned

amount_returned

number | null · decimal

Amount returned to the tenant

retained_for_charges

number | null · decimal

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

retained_for_damages

number | null · decimal

Amount retained for property damages

retained_for_unpaid_rent

number | null · decimal

Amount retained for unpaid rent

penalty_amount

number | null · decimal

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

copro_accounts_approval_date

string | null · date

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

notes

string | null

Additional notes

Record a security deposit

POST

https://api.faireplace.com/api

/leases/{lease_id}/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

Record a security deposit › path Parameters

lease_id

string · uuid · required

Lease ID

Record a security deposit › Request Body

Request to record a security deposit collection

RecordDeposit

amount

number · decimal · required

Deposit amount

Example: 750

paid_date

string | null · date

Date the deposit was collected

Example: 2026-01-15

Record a security deposit › Responses

Deposit recorded successfully

SecurityDeposit

id

string · uuid · required

lease_id

string · uuid · required

amount

number · decimal · required

Deposit amount collected

Example: 750

status

string · required

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

Example: COLLECTED

exit_inspection_conformity

boolean · required

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

Example: true

paid_date

string | null · date

Date the deposit was collected

Example: 2026-01-15

restitution_due_date

string | null · date

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

restitution_date

string | null · date

Actual date the deposit was returned

amount_returned

number | null · decimal

Amount returned to the tenant

retained_for_charges

number | null · decimal

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

retained_for_damages

number | null · decimal

Amount retained for property damages

retained_for_unpaid_rent

number | null · decimal

Amount retained for unpaid rent

penalty_amount

number | null · decimal

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

copro_accounts_approval_date

string | null · date

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

notes

string | null

Additional notes

POST/leases/{lease_id}/deposit

curl https://api.faireplace.com/api/leases/:lease_id/deposit \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "amount": 750,
  "paid_date": "2026-01-15"
}'

Example Request Body

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

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "lease_id": "00000000-0000-0000-0000-000000000000",
  "amount": 750,
  "paid_date": "2026-01-15",
  "status": "COLLECTED",
  "restitution_due_date": "2024-08-25",
  "restitution_date": "2024-08-25",
  "amount_returned": 0,
  "retained_for_charges": 0,
  "retained_for_damages": 0,
  "retained_for_unpaid_rent": 0,
  "penalty_amount": 0,
  "exit_inspection_conformity": true,
  "copro_accounts_approval_date": "2024-08-25",
  "notes": "notes"
}

json

application/json

Delete a security deposit

DELETE

https://api.faireplace.com/api

/leases/{lease_id}/deposit

Delete the security deposit record for a lease.

Permissions required: leases:delete

Delete a security deposit › path Parameters

lease_id

string · uuid · required

Lease ID

Delete a security deposit › Responses

Deposit deleted successfully

No data returned

Return a security deposit

POST

https://api.faireplace.com/api

/leases/{lease_id}/deposit/return

Record the return (restitution) of a security deposit.

Art. 22 Loi 89-462 compliance:

Restitution deadline:

Exit inspection conformity → 1 month after lease end
Exit inspection non-conformity → 2 months after lease end

Retention limits:

Charge provisions (co-ownership): max 20% of deposit amount
Damages and unpaid rent: justified amounts, total cannot exceed deposit

Late penalty:

If restitution_date exceeds the calculated deadline, a penalty of 10% of monthly rent (HC) per full month of delay is automatically computed.

The system calculates:

restitution_due_date from lease_end_date + conformity status
amount_returned = deposit - (charges + damages + unpaid rent)
penalty_amount if return is late
status: FULLY_RETURNED or PARTIALLY_RETURNED (if only charges retained for co-ownership)

Permissions required: leases:write

Return a security deposit › path Parameters

lease_id

string · uuid · required

Lease ID

Return a security deposit › Request Body

Request to record the return of a security deposit. The system automatically: - Calculates the restitution deadline (1 or 2 months based on exit inspection) - Validates that charge retention does not exceed 20% (Art. 22) - Validates that total retentions do not exceed the deposit amount - Computes the late return penalty if applicable (10% of monthly rent per month)

ReturnDeposit

exit_inspection_conformity

boolean · required

true = conformity (1-month deadline), false = non-conformity (2-month deadline)

Example: true

lease_end_date

string · date · required

End date of the lease (used to calculate restitution deadline)

Example: 2026-03-31

restitution_date

string · date · required

Actual date of deposit return

Example: 2026-04-15

retained_for_charges

number | null · decimal

Amount retained for co-ownership charges (max 20% of deposit)

Example: 150

retained_for_damages

number | null · decimal

Amount retained for property damages

Example: 0

retained_for_unpaid_rent

number | null · decimal

Amount retained for unpaid rent

Example: 0

copro_accounts_approval_date

string | null · date

Date of syndic account approval (if retaining for charges)

notes

string | null

Additional notes about the return

Return a security deposit › Responses

Deposit return recorded successfully

SecurityDeposit

id

string · uuid · required

lease_id

string · uuid · required

amount

number · decimal · required

Deposit amount collected

Example: 750

status

string · required

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

Example: COLLECTED

exit_inspection_conformity

boolean · required

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

Example: true

paid_date

string | null · date

Date the deposit was collected

Example: 2026-01-15

restitution_due_date

string | null · date

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

restitution_date

string | null · date

Actual date the deposit was returned

amount_returned

number | null · decimal

Amount returned to the tenant

retained_for_charges

number | null · decimal

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

retained_for_damages

number | null · decimal

Amount retained for property damages

retained_for_unpaid_rent

number | null · decimal

Amount retained for unpaid rent

penalty_amount

number | null · decimal

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

copro_accounts_approval_date

string | null · date

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

notes

string | null

Additional notes

POST/leases/{lease_id}/deposit/return

curl https://api.faireplace.com/api/leases/:lease_id/deposit/return \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "exit_inspection_conformity": true,
  "lease_end_date": "2026-03-31",
  "restitution_date": "2026-04-15",
  "retained_for_charges": 150,
  "retained_for_damages": 0,
  "retained_for_unpaid_rent": 0,
  "copro_accounts_approval_date": "2024-08-25",
  "notes": "notes"
}'

Example Request Body

{
  "exit_inspection_conformity": true,
  "lease_end_date": "2026-03-31",
  "restitution_date": "2026-04-15",
  "retained_for_charges": 150,
  "retained_for_damages": 0,
  "retained_for_unpaid_rent": 0,
  "copro_accounts_approval_date": "2024-08-25",
  "notes": "notes"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "lease_id": "00000000-0000-0000-0000-000000000000",
  "amount": 750,
  "paid_date": "2026-01-15",
  "status": "COLLECTED",
  "restitution_due_date": "2024-08-25",
  "restitution_date": "2024-08-25",
  "amount_returned": 0,
  "retained_for_charges": 0,
  "retained_for_damages": 0,
  "retained_for_unpaid_rent": 0,
  "penalty_amount": 0,
  "exit_inspection_conformity": true,
  "copro_accounts_approval_date": "2024-08-25",
  "notes": "notes"
}

json

application/json

Estate Diagnostics Rent Receipts