---
title: "List my rent receipts (tenant)"
method: GET
path: "/tenant/receipts"
tags: ["Rent Receipts", "Lessees"]
---

# List my rent receipts (tenant)

`GET /tenant/receipts`

## Request

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

Returns the receipts of the **connected tenant**, across all their
leases. The tenant is resolved from the JWT: there is no identifier to
pass, and none would be trusted.

Only receipts actually **sent** appear. Drafts, sends in flight and
failed sends stay invisible: a tenant should not see a document their
landlord has not issued to them yet.

Requires the `lessee:leases:read` permission.

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