What's New: Landlord Dashboard API Routes (v0.1.20)
What's New: Landlord Dashboard API Routes (v0.1.20)
Version 0.1.20 introduces the complete set of Next.js API routes that power the landlord portal in myProp. These server-side routes act as the data layer between the landlord-facing UI and the AgentOS (letmc.com) platform, enabling real-time access to portfolio, tenancy, financial, and maintenance data — all without a landlord needing to call their agency.
Endpoints at a Glance
| Area | Endpoint | Purpose |
|---|---|---|
| Insights | /api/landlord/insights | KPIs and portfolio summary metrics |
| Maintenance | /api/landlord/maintenance | List of all maintenance jobs |
| Maintenance Notes | /api/landlord/maintenance/[jobId]/notes | Notes and updates for a specific job |
| Rent Arrears | /api/landlord/arrears | Outstanding rent balances by tenancy |
| Portfolio | /api/landlord/portfolio | Top-level portfolio structure |
| Property Blocks | /api/landlord/blocks | Block-level property groupings |
| Statements | /api/landlord/statements | Historical financial statements (paginated) |
| Tenancies | /api/landlord/tenancies | Active and historical tenancy records |
Feature Details
Insights & KPIs
The insights endpoint aggregates key performance indicators for a landlord's entire portfolio. This powers the summary cards at the top of the landlord dashboard, giving at-a-glance visibility into occupancy, active tenancies, and managed unit counts.
Maintenance Jobs & Notes
Landlords can now view all maintenance requests raised across their properties. Each job record includes status, description, and assigned contractor information. A dedicated notes sub-endpoint returns the full conversation thread for any individual job, so landlords can follow progress without contacting the agency.
Rent Arrears
The arrears endpoint exposes outstanding balance data per tenancy, drawn directly from AgentOS in real time. This allows landlords to identify and monitor overdue payments from within the portal.
Portfolio Structure & Property Blocks
Two endpoints work together to model a landlord's property holdings:
- Portfolio — returns the top-level view of all managed properties grouped by ownership.
- Property Blocks — provides block-level groupings for landlords who own units within larger managed developments.
Historical Statements
Landlords can retrieve their full financial statement history through a paginated statements endpoint. This replaces the need to request PDF statements from the agency manually.
Tenancy Management
Tenancy endpoints cover both active and historical tenancies, giving landlords a complete occupancy record for each property — including current tenant details and previous letting history.
Architecture Note
All routes in this release are implemented as Next.js API routes and authenticate against the AgentOS API on behalf of the logged-in landlord. Data is fetched server-side to keep credentials and agency-specific configuration out of the browser.