---
title: "Simulate a rent revision (explicit IRL values)"
method: POST
path: "/public/tools/irl/simulate"
tags: ["Public Tools"]
---

# Simulate a rent revision (explicit IRL values)

`POST /public/tools/irl/simulate`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/public/tools/irl/simulate`
- Auth: none required

Computes the revised rent from a current rent and two explicit IRL
quarter values supplied by the caller (Art. 17-1 Loi 89-462).

Public, unauthenticated tool: no `Authorization` header required.

## Example

```bash
curl -X POST https://api.faireplace.com/api/public/tools/irl/simulate \
  -H "Content-Type: application/json" \
  -d '{
    "current_rent": 850.00,
    "old_irl_quarter": "T2-2023",
    "old_irl_value": 136.27,
    "new_irl_quarter": "T2-2024",
    "new_irl_value": 143.46,
    "effective_date": "2024-07-01"
  }'
```

**Response**:
```json
{
  "previous_rent": 850.00,
  "new_rent": 894.85,
  "old_irl_quarter": "T2-2023",
  "new_irl_quarter": "T2-2024",
  "variation_percentage": 5.27,
  "monthly_increase": 44.85,
  "annual_increase": 538.20,
  "effective_date": "2024-07-01"
}
```

## Request body

- IrlSimulateRequest: Rent revision simulation using two explicit IRL quarter values supplied by the caller. Use `IrlSimulateByQuartersRequest` to let the server look up the trusted IRL values instead (no typo risk).
  - `current_rent` number, required: Current monthly rent excluding charges.
  - `old_irl_quarter` string, required: Reference quarter of the current rent (format `T[1-4]-YYYY`).
  - `old_irl_value` number, required
  - `new_irl_quarter` string, required
  - `new_irl_value` number, required
  - `effective_date` string, date, required: Date the revised rent takes effect.

## Response `200`

Rent revision computed.

- IrlSimulateResponse
  - `previous_rent` number, required
  - `new_rent` number, required
  - `old_irl_quarter` string, required
  - `old_irl_value` number, required
  - `new_irl_quarter` string, required
  - `new_irl_value` number, required
  - `variation_percentage` number, required
  - `effective_date` string, date, required
  - `monthly_increase` number, required
  - `annual_increase` number, required: 12 × monthly increase, rounded to 2 decimals.

## 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)