---
title: "List rent receipts"
method: GET
path: "/leases/{lease_id}/receipts"
tags: ["Leases"]
---

# List rent receipts

`GET /leases/{lease_id}/receipts`

## Request

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

List all rent receipts for a lease, ordered by period (most recent first).

Optionally filter by `lessee_id` to get receipts for a specific tenant.

**Permissions required:** `leases:read`

## Path parameters

- `lease_id` string, uuid, required

## Query parameters

- `lessee_id` string, uuid

## Response `200`

List of rent receipts

- RentReceipt[]
  - `id` string, uuid, required: Unique identifier of the rent receipt
  - `lease_id` string, uuid, required: ID of the associated lease
  - `lessee_id` string, uuid, required: ID of the tenant this receipt is for
  - `lessee_name` string, required: Full name of the tenant
  - `period_start` string, date, required: Start date of the rental period
  - `period_end` string, date, required: End date of the rental period
  - `rent_amount` number, required: Rent amount for this tenant (adjusted by rent_share)
  - `charges_total` number, required: Total charges amount for this tenant (adjusted by rent_share)
  - `charges_detail` RentReceiptChargeDetail[], required: Itemized charge breakdown by category
    - `category_name` string, required: Name of the charge category (e.g., "Eau froide", "Chauffage collectif")
    - `category_id` string, uuid, nullable: UUID of the charge category (if available)
    - `amount` number, required: Amount for this charge line, adjusted by tenant's rent share
    - `calculation_method` string, required: Billing method used for this charge (e.g., Provision, Forfait)
  - `total_due` number, required: Total amount due (rent + charges)
  - `amount_paid` number, required: Amount actually paid by the tenant
  - `document_type` string, required: QUITTANCE (full payment) or RECU (partial payment)
  - `has_pdf` boolean, required: Whether a PDF has been generated for this receipt

## Other responses

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