---
title: "Check whether the organisation can send rent receipts"
method: GET
path: "/quittance-access"
tags: ["Rent Receipts", "Credits"]
---

# Check whether the organisation can send rent receipts

`GET /quittance-access`

## Request

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

Reads the entitlement that gates the *emailing* of rent receipts.

Two things can grant it: a paid plan, or the €4.90 one-shot purchase
which opens a one-year window. `entitled` already accounts for both:
base your UI on it, not on `access_until`, which is `null` whenever the
access comes from the plan.

Without entitlement, `POST /leases/{lease_id}/receipts/{receipt_id}/send`
answers `402`. Generation and the tenant's own access to the document
are never gated.

## Response `200`

OK

- QuittanceAccessStatus: Whether the organisation may send rent receipts, and until when.
  - `entitled` boolean, required: `true` when rent receipts can be emailed: either because the plan includes them, or because a €4.90 one-shot window is still open.
  - `access_until` string, date, nullable: End of the one-shot window. `null` when there is none, which does **not** mean "no access": entitlement may come from the plan. Always read `entitled` for the decision, and use this only to display the renewal date.

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