---
title: "Rent receipts and invoices"
method: POST
path: "/api/v1/tools/rent_document"
---

# Rent receipts and invoices

`POST /api/v1/tools/rent_document`

## Request

- Base URL: `https://verified.realestate`
- URL: `https://verified.realestate/api/v1/tools/rent_document`
- Auth: HTTP bearer

GENERATE rent receipts or rent invoices as a ready PDF (one page per month for the whole period, up to 24 months) and return the download link. type "receipt" = tenant-side rent receipts for HRA / income tax proof, with the landlord PAN line and an optional revenue stamp. type "invoice" = landlord-side rent invoices with due dates, and 18% GST split into CGST/SGST automatically when the let is commercial AND a landlord GSTIN is given. Use for "rent receipt for HRA", "monthly rent receipts for last year", "rent invoice for my tenant", "12 months of rent receipts with my PAN". Gather the fields conversationally first. If the user would rather fill the form themselves, the rent-receipt / rent-invoice template of the separate document drafting tool does that instead. Free.

## Request body

- object
  - `type` 'receipt' | 'invoice', required: receipt = tenant HRA proof, invoice = landlord billing (GST aware)
  - `landlord_name` string, required
  - `tenant_name` string, required
  - `property_address` string, required: Full address of the let property
  - `rent_amount` number, required: Monthly rent in rupees (the same amount is billed every month of the period)
  - `period_from` string, required: First month, YYYY-MM (e.g. 2026-04). "April 2026" is accepted too.
  - `period_to` string, required: Last month, YYYY-MM. Max 24 months from period_from.
  - `payment_mode` 'Cash' | 'UPI' | 'Bank Transfer' | 'Cheque'
  - `landlord_pan` string: Landlord PAN, format ABCDE1234F. Needed on receipts when annual rent crosses Rs 1,00,000.
  - `include_revenue_stamp` boolean: receipt only: print the Re 1 revenue stamp box (cash rent above Rs 5,000).
  - `landlord_address` string: invoice only, REQUIRED: the landlord billing address.
  - `property_type` 'residential' | 'commercial': invoice only, REQUIRED. commercial + a GSTIN triggers the 18% GST lines.
  - `landlord_gstin` string: invoice only: 15 character GSTIN. Only then is GST charged.
  - `due_day` integer: invoice only: day of month the rent falls due, 1 to 28. Defaults to 5.
  - `signature_text` string: Optional typed signature name to print in the signature box.

## Response `200`

The envelope: ok, status, data, credits_charged, balance_after, request_id

## Other responses

- `401`: No valid credential
- `402`: Not enough credits
- `429`: Rate limit

---

[API](https://skmtc.dev/verified/apis/landlens-tool-api.md) · [All operations](https://skmtc.dev/verified/apis/landlens-tool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/verified/apis/landlens-tool-api/revisions/7923c1c24431?raw)