---
title: "List every rent receipt of the organisation"
method: GET
path: "/receipts"
tags: ["Rent Receipts"]
---

# List every rent receipt of the organisation

`GET /receipts`

## Request

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

Cross-lease view of the rent receipts issued by the landlord, optionally
narrowed to a period.

Each row already carries the property label and the tenant's name, so a
table can be rendered from this single call: no fan-out into
`/leases`, `/estates` and `/lessees`.

For the per-lease list, use `GET /leases/{lease_id}/receipts`.

## Query parameters

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

## Response `200`

OK

- RentReceiptSummary[]
  - `receipt_id` string, uuid
  - `lease_id` string, uuid
  - `lessee_id` string, uuid
  - `property_label` string: Libellé lisible du bien : « nom, adresse ». L'adresse est **omise quand elle n'ajoute rien**: beaucoup de bailleurs nomment leur bien par son adresse, et la coller deux fois donnait des lignes identiques pour chaque lot d'un même immeuble. Un numéro de lot présent dans le nom reste donc distinctif, alors qu'un nom qui reprend mot pour mot l'adresse se suffit à lui-même.
  - `lessee_name` string: Legal name if the tenant is a company, otherwise first + last name.
  - `period_start` string, date
  - `period_end` string, date
  - `total_due` string: Total amount of the receipt, as a decimal string.
  - `document_type` string: `QUITTANCE` when the rent was paid in full, `RECU` for a partial payment: the two are legally distinct documents.
  - `delivery_status` 'PENDING' | 'QUEUED' | 'SENT' | 'FAILED': - `PENDING`: generated, never sent - `QUEUED`: send accepted, delivery in flight - `SENT`: delivered to the tenant - `FAILED`: delivery failed; the receipt may be sent again
  - `sent_at` string, nullable: When the receipt was emailed. `null` when it has not been sent. **No timezone offset** is carried by this field: read it as Europe/Paris, and do not feed it to a parser that assumes UTC.

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