---
title: "Monthly rent tracking across all active leases"
method: GET
path: "/rent-status"
tags: ["Rent Receipts", "Leases"]
---

# Monthly rent tracking across all active leases

`GET /rent-status`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/rent-status`
- Auth: HTTP bearer

The landlord's monthly dashboard: one row per active lease, telling you
whether the rent for the period was received and whether the receipt has
been produced and sent.

Both `period_start` and `period_end` are **required**: this is a view of
a given month, not an open-ended history.

`payment_status` is computed, not stored: `paid` when a payment is
recorded, otherwise `late` or `pending` depending on whether the lease's
due date for that period has passed. The due day is clamped to the
length of the month, so a lease due on the 31st falls due on 28 February.

Served by a single read model: no N+1 behind it, so it stays usable on
large portfolios.

## Query parameters

- `period_start` string, date, required
- `period_end` string, date, required

## Response `200`

OK

- RentStatusRow[]
  - `lease_id` string, uuid
  - `property_label` string: Libellé lisible du bien : « nom, adresse ». L'adresse est omise quand le nom la reprend déjà.
  - `tenant_name` string
  - `rent_amount` string: Rent for the period, as a decimal string.
  - `payment_status` 'paid' | 'pending' | 'late': - `paid`: payment recorded for the period - `pending`: not received yet, due date not passed - `late`: due date passed and nothing recorded The due date is the lease's payment day, clamped to the length of the month (a lease due on the 31st falls due on the 28th in February).
  - `receipt_id` string, uuid, nullable: Receipt for this period, `null` if none was generated yet.
  - `receipt_status` string, nullable: Delivery status of that receipt, `null` when there is none.

## Other responses

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