Split rent
split_rentUse this when roommates or housemates want to split rent fairly: by bedroom size (square feet or metres) with a shared-space portion split per occupant, by income, or equally, with optional per-room adjustments (private bathroom, no window), couples sharing a room, and utilities split per occupant. Every amount is exact to the cent and the parts add up exactly to the rent. Does not give legal or tenancy advice, collect rent, or handle one-off shared expenses (use settle_group_expenses for those).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| basis | No | How to split: room_size (default when every room has a size), income (in proportion to income), or equal (per occupant). | |
| rooms | Yes | Each bedroom or person. Example: [{"name": "Ana", "size": 160}, {"name": "Ben", "size": 120}, {"name": "Chloe", "size": 100}]. | |
| currency | No | ISO 4217 code, e.g. USD, EUR, GBP. Defaults to USD. | |
| total_rent | Yes | Total monthly rent for the home, e.g. 3200. | |
| extra_costs | No | Other monthly costs split equally per occupant, e.g. 180 for utilities and internet. | |
| shared_area | No | Area of shared space (kitchen, living room, shared bathroom) in the same unit as the room sizes, e.g. 400. Its share of the total area is split equally per occupant. | |
| shared_percent | No | Alternative to shared_area: percent of the rent treated as shared space and split equally per occupant, e.g. 40. Defaults to 50 for room_size when shared_area is not given. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| basis | Yes | ||
| hints | Yes | ||
| rooms | Yes | ||
| totals | Yes | ||
| display | Yes | ||
| currency | Yes | ||
| settings | Yes | ||
| warnings | Yes | ||
| assumptions | Yes | ||
| minor_units | Yes | ||
| shared_source | Yes | ||
| shared_percent | Yes |