Receipts
Bequest issues IRS-compliant tax receipts the moment a gift to a verified 501(c)(3) settles. Receipts are addressable as their own resource and re-issuable for the lifetime of the gift.
The Receipt object
{
"id": "rcp_01HZ...",
"gift_id": "gft_01HZ...",
"donor_id": "usr_8f3...",
"recipient_id": "org_a91...",
"amount_cents": 2500,
"tax_year": 2026,
"issued_at": "2026-05-15T13:45:11Z",
"pdf_url": "https://2026.bequest.org/r/rcp_01HZ.pdf",
"html_url": "https://2026.bequest.org/r/rcp_01HZ"
}
GET
/v1/receipts/{id}
Retrieve a receipt by id.
| Field | Type | Description | |
|---|---|---|---|
| id | string | required | Receipt id, prefixed `rcp_`. |
GET
/v1/receipts
List receipts for an identity (donor or recipient) or a tax year.
| Field | Type | Description | |
|---|---|---|---|
| donor_id | string | optional | Filter to receipts issued to this donor. |
| recipient_id | string | optional | Filter to receipts issued by this recipient. |
| tax_year | integer | optional | Calendar year. |
| limit | integer | optional | Default 25. |
| cursor | string | optional | Pagination cursor. |
POST
/v1/receipts/{id}/reissue
Re-render the receipt and email it to the donor. Useful for an updated address or a fresh PDF.
| Field | Type | Description | |
|---|---|---|---|
| email_to | string | optional | Override the donor address on file. |
GET
/v1/receipts/{id}/render
Render the receipt as a PDF (default) or HTML.
| Field | Type | Description | |
|---|---|---|---|
| format | string | optional | pdf (default) | html | json |
Eligibility
A receipt is automatically issued when:
- The gift status is
settled. - The recipient is a verified 501(c)(3) (or equivalent in another jurisdiction).
- The donor's identity is at KYC tier 0 or higher (effectively: an email).
Events
receipt.issuedreceipt.reissued