---
title: "Record a rent revision"
method: POST
path: "/leases/{lease_id}/rent-revisions"
tags: ["Rent Revisions"]
---

# Record a rent revision

`POST /leases/{lease_id}/rent-revisions`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/rent-revisions`
- Auth: HTTP bearer

Records (persists) an IRL-based rent revision for a lease.

The revision is computed from the provided IRL reference quarter and stored as a
historical record. Recording does **not** change the active rent: call
`PUT /leases/{lease_id}/rent-revisions/{revision_id}/apply` to apply it.

## Usage Example

```bash
curl -X POST https://api.faireplace.com/api/leases/660e8400-e29b-41d4-a716-446655440001/rent-revisions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "new_irl_quarter": "T3-2024",
    "effective_date": "2025-07-01"
  }'
```

## Path parameters

- `lease_id` string, uuid, required

## Request body

- RecordRevisionRequest: Request to record (persist) a rent revision for a lease. The revision is computed from the provided IRL reference quarter and stored as a historical record. Use `PUT .../apply` afterwards to apply it to the active rent.
  - `new_irl_quarter` string, required: IRL reference quarter to apply, in the format `T{quarter}-{year}`. Must not be empty.
  - `effective_date` string, date, required: Effective date of the revision (ISO 8601 `YYYY-MM-DD`).

## Response `201`

Revision recorded successfully

- RentRevisionRecord: A persisted rent revision record. Captures the indexation applied to a lease, including the previous and new rent, the IRL index value used, and any applicable increase cap or special period.
  - `id` string, uuid, required: Unique identifier of the revision record.
  - `tenant_id` string, required: Tenant (organization) identifier owning this revision.
  - `lease_id` string, uuid, required: Lease to which the revision applies.
  - `index_value_id` string, uuid, required: Identifier of the IRL index value used for the revision.
  - `increase_cap_id` string, uuid, nullable: Identifier of the increase cap applied, if any.
  - `special_period_id` string, uuid, nullable: Identifier of the special (legislative) period applied, if any.
  - `revision_date` string, date, required: Effective date of the revision (ISO 8601).
  - `previous_amount` number, double, required: Rent amount before the revision (in euros).
  - `new_amount` number, double, required: Rent amount after the revision (in euros).
  - `percentage_change` number, double, required: Percentage change between previous and new rent.
  - `capped_increase` boolean, required: Whether the increase was capped by a legislative increase cap.
  - `revision_details` object, nullable: Free-form JSON details about the revision computation.
  - `created_at` string, date-time, required: Creation timestamp (ISO 8601).
  - `updated_at` string, date-time, required: Last update timestamp (ISO 8601).

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `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)