---
title: "Send a rent receipt to the tenant by email"
method: POST
path: "/leases/{lease_id}/receipts/{receipt_id}/send"
tags: ["Rent Receipts", "Leases"]
---

# Send a rent receipt to the tenant by email

`POST /leases/{lease_id}/receipts/{receipt_id}/send`

## Request

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

Queues the emailing of an already generated receipt. The send is
asynchronous: a `202` means "accepted for delivery", not "delivered".
Poll `GET /leases/{lease_id}/receipts/{receipt_id}` and read
`delivery_status` (`PENDING` → `QUEUED` → `SENT` / `FAILED`).

## Three gates, three different failures
The call is refused, with distinct status codes, when:

- **the PDF is not archived yet** → `400`. Generate it first
  (`POST /leases/{lease_id}/receipts/generate`, or
  `POST …/regenerate-pdf` if it was lost).
- **a send is already running or has succeeded** → `400`. Only `PENDING`
  and `FAILED` receipts may be sent; `QUEUED` and `SENT` are refused, so
  a double click cannot email the tenant twice.
- **the landlord has no rent-receipt entitlement** → `402`. Either a
  paid plan or the €4.90/year one-shot credit is required
  (`GET /quittance-access`).
- **the tenant has not consented to email delivery** → `409`. See
  `POST /leases/{lease_id}/lessees/{lessee_id}/request-consent`.

In every one of those cases the receipt still exists and stays readable
by the tenant in their portal: refusing the *email* never withholds the
document itself.

## Path parameters

- `lease_id` string, uuid, required
- `receipt_id` string, uuid, required

## Response `202`

Send accepted; delivery continues asynchronously.

- object
  - `receipt_id` string, uuid
  - `delivery_status` 'PENDING' | 'QUEUED' | 'SENT' | 'FAILED': Status right after queuing: normally `QUEUED`.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: No rent-receipt entitlement: a paid plan or the €4.90/year one-shot credit is required. Check with `GET /quittance-access`.
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `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)