---
title: "Get tenant balance"
method: GET
path: "/leases/{lease_id}/rent-payments/balance"
tags: ["Rent Payments"]
---

# Get tenant balance

`GET /leases/{lease_id}/rent-payments/balance`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/rent-payments/balance`
- Auth: HTTP bearer

Returns the aggregated balance for a lease: total expected, total paid, arrears, overpayment, and count of unpaid periods.

**Permissions required:** `leases:read`

## Path parameters

- `lease_id` string, uuid, required

## Response `200`

Lease balance

- LeaseBalanceResponse
  - `lease_id` string, uuid
  - `total_expected` number: Total expected rent across all periods
  - `total_paid` number: Total amount paid
  - `arrears` number: Amount owed (total_expected - total_paid, min 0)
  - `overpayment` number: Overpayment amount (total_paid - total_expected, min 0)
  - `unpaid_periods` integer: Count of periods with LATE or UNPAID status

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

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