---
title: "List rent revisions"
method: GET
path: "/leases/{lease_id}/rent-revisions"
tags: ["Rent Revisions"]
---

# List rent revisions

`GET /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

Retrieves the full history of recorded rent revisions for a lease, ordered chronologically.

## Usage Example

```bash
curl -X GET https://api.faireplace.com/api/leases/660e8400-e29b-41d4-a716-446655440001/rent-revisions \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Revision history retrieved successfully

- RentRevisionRecord[]
  - `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

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