Public Tools

Calculate a security-deposit restitution

Computes the legal deposit cap, restitution deadline, allowed retentions and any late penalty (Art. 22 Loi 89-462). Returns JSON.

Public, unauthenticated tool.

Example

curl -X POST https://api.faireplace.com/api/public/tools/depot-garantie/calculate \
  -H "Content-Type: application/json" \
  -d '{
    "lease_type": "vide",
    "monthly_rent_hc": 750.00,
    "deposit_amount": 750.00,
    "lease_end_date": "2026-03-31",
    "exit_inspection_conformity": true
  }'
post/public/tools/depot-garantie/calculate

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/public/tools/depot-garantie/calculate
  • Auth: none required

Request body

lease_typestring required

Lease type, drives the legal cap: vide (1× rent HC), meuble (2× rent HC), mobilite (deposit forbidden).

monthly_rent_hcnumber required

Monthly rent excluding charges. Used for the late penalty.

deposit_amountnumber required

Deposit actually collected at signature.

lease_end_datestring date required

Effective end date of the lease (move-out).

exit_inspection_conformityboolean nullable

Exit inspection conform to the entry one? true → 1-month restitution deadline; false → 2 months. Defaults to true if omitted.

retained_for_chargesnumber nullable

Optional retention for co-ownership charge provisions (EUR).

retained_for_damagesnumber nullable

Optional retention for damages (EUR).

retained_for_unpaid_rentnumber nullable

Optional retention for unpaid rent (EUR).

actual_return_datestring date nullable

Actual restitution date (if known): enables late-penalty calc.

Example request

{
  "lease_type": "vide",
  "monthly_rent_hc": 750,
  "deposit_amount": 750,
  "lease_end_date": "2026-03-31",
  "exit_inspection_conformity": true
}

Response

Restitution computed.

lease_typestring required
monthly_rent_hcnumber required
deposit_amountnumber required
legal_deposit_capnumber nullable

Legal cap of the exigible deposit (null for mobility = forbidden).

deposit_exceeds_capboolean required
exit_inspection_conformityboolean required
restitution_deadline_monthsinteger required
restitution_due_datestring date required
max_charge_retentionnumber required

Max 20% retention allowed for charge provisions.

retained_for_chargesnumber required
retained_for_damagesnumber required
retained_for_unpaid_rentnumber required
total_retainednumber required
amount_before_penaltynumber required

Amount remaining after retentions, before any penalty.

late_penaltynumber required

Late penalty owed by the landlord (10% rent HC × months late).

net_to_return_to_tenantnumber required

Total the landlord must return (amount_before_penalty + late_penalty).

legal_basisstring required
warningsstring[] required

Example response

{
  "lease_type": "vide",
  "monthly_rent_hc": 750,
  "deposit_amount": 750,
  "legal_deposit_cap": 750,
  "exit_inspection_conformity": true,
  "restitution_deadline_months": 1,
  "restitution_due_date": "2026-04-30",
  "max_charge_retention": 150,
  "amount_before_penalty": 750,
  "net_to_return_to_tenant": 750,
  "legal_basis": "Art. 22 Loi n° 89-462 du 6 juillet 1989",
  "warnings": []
}

Changes

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