Public Tools

Simulate rental yield across tax regimes

Computes gross/net yield, per-regime tax breakdown, cashflow and the recommended fiscal regime for a rental investment. Public, unauthenticated tool.

Example

curl -X POST https://api.faireplace.com/api/public/tools/rendement-locatif/simulate \
  -H "Content-Type: application/json" \
  -d '{
    "purchase_price": 200000,
    "notary_fees": 16000,
    "monthly_rent": 800,
    "annual_charges": 2000,
    "furnishing": "furnished_long_term",
    "tmi_percent": 30
  }'
post/public/tools/rendement-locatif/simulate

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/public/tools/rendement-locatif/simulate
  • Auth: none required

Request body

purchase_pricenumber required
notary_feesnumber required
renovation_costnumber

Default 0.

monthly_rentnumber required
annual_chargesnumber required
annual_deductible_worksnumber

Annual deductible works in the réel foncier regime. Default 0.

is_energy_renovationboolean

Works eligible for the energy-renovation deficit ceiling (21 400€). Default false.

vacancy_weeks_per_yearinteger

Rental vacancy in weeks per year. Default 0.

furnishing'unfurnished' | 'furnished_long_term' | 'furnished_tourism_classified' | 'furnished_tourism_unclassified' required

Lease/furnishing type for the rental-yield simulation. The legacy alias furnished is also accepted and maps to furnished_long_term.

tmi_percentnumber required

Marginal income-tax rate (%).

prelevements_sociaux_percentnumber

Social levies rate (%). Default 17.2.

Example request

{
  "purchase_price": 200000,
  "notary_fees": 16000,
  "monthly_rent": 800,
  "annual_charges": 2000,
  "furnishing": "furnished_long_term",
  "tmi_percent": 30,
  "prelevements_sociaux_percent": 17.2,
  "financing": {
    "loan_amount": 150000,
    "annual_rate_percent": 3.5,
    "duration_years": 20
  }
}

Response

Yield simulation result.

total_investmentnumber required
annual_rent_grossnumber required
annual_rent_effectivenumber required
gross_yield_percentnumber required
net_yield_percentnumber required
loan_monthly_paymentnumber nullable
loan_first_year_interestnumber nullable
recommended_regime'micro_foncier' | 'reel_foncier' | 'micro_bic' | 'reel_lmnp' required
recommended_regime_labelstring required
is_likely_lmpboolean required

The landlord may qualify for the LMP (professional furnished) status.

lmp_warningstring

LMP warning message, present only when applicable.

legal_sourcesstring[] required

Example response

{
  "total_investment": 216000,
  "annual_rent_gross": 9600,
  "annual_rent_effective": 9600,
  "gross_yield_percent": 4.44,
  "net_yield_percent": 3.52,
  "regimes": [
    {
      "regime": "micro_bic",
      "regime_label": "Micro-BIC",
      "taxable_base": 4800,
      "annual_tax": 2266,
      "annual_cashflow": 5200,
      "monthly_cashflow": 433.33,
      "net_net_yield_percent": 2.45,
      "is_eligible": true
    }
  ],
  "recommended_regime": "micro_bic",
  "recommended_regime_label": "Micro-BIC"
}

Changes

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