---
title: "Simulate rental yield across tax regimes"
method: POST
path: "/public/tools/rendement-locatif/simulate"
tags: ["Public Tools"]
---

# Simulate rental yield across tax regimes

`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

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

## Example

```bash
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
  }'
```

## Request body

- RendementSimulateRequest
  - `purchase_price` number, required
  - `notary_fees` number, required
  - `renovation_cost` number: Default 0.
  - `monthly_rent` number, required
  - `annual_charges` number, required
  - `annual_deductible_works` number: Annual deductible works in the réel foncier regime. Default 0.
  - `is_energy_renovation` boolean: Works eligible for the energy-renovation deficit ceiling (21 400€). Default false.
  - `vacancy_weeks_per_year` integer: 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_percent` number, required: Marginal income-tax rate (%).
  - `prelevements_sociaux_percent` number: Social levies rate (%). Default 17.2.
  - `financing` RendementFinancing: Optional mortgage financing parameters.
    - `loan_amount` number, required
    - `annual_rate_percent` number, required
    - `duration_years` integer, required

## Response `200`

Yield simulation result.

- RendementSimulateResponse
  - `total_investment` number, required
  - `annual_rent_gross` number, required
  - `annual_rent_effective` number, required
  - `gross_yield_percent` number, required
  - `net_yield_percent` number, required
  - `loan_monthly_payment` number, nullable
  - `loan_first_year_interest` number, nullable
  - `regimes` RegimeBreakdown[], required
    - `regime` 'micro_foncier' | 'reel_foncier' | 'micro_bic' | 'reel_lmnp', required
    - `regime_label` string, required
    - `taxable_base` number, required
    - `annual_tax` number, required
    - `deficit_foncier_imputed_on_global_income` number: Land deficit imputed on global income (réel foncier only). Omitted otherwise.
    - `annual_cashflow` number, required
    - `monthly_cashflow` number, required
    - `net_net_yield_percent` number, required
    - `is_eligible` boolean, required
    - `ineligibility_reason` string, nullable
  - `recommended_regime` 'micro_foncier' | 'reel_foncier' | 'micro_bic' | 'reel_lmnp', required
  - `recommended_regime_label` string, required
  - `is_likely_lmp` boolean, required: The landlord may qualify for the LMP (professional furnished) status.
  - `lmp_warning` string: LMP warning message, present only when applicable.
  - `legal_sources` string[], required

## Other responses

- `400`: Bad request
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)