Rental estimate

Returns an estimated monthly rent (PCM) for a specific property, taken as the median of nearby rental comparables, together with an implied gross yield. Use it to size income for a buy-to-let appraisal without running a full comparables pull. Required scope: market-data:read · Cost: 1 request

GET /api/v1/rental-estimate

Authenticate with a paid API key (Authorization: Bearer paid_your_key). The endpoint also accepts a logged-in Clerk session when called from the dashboard. Anonymous requests are rejected.

Query parameters

Param	Type	Default	Description
`property_id`	string	—	Required. Internal property UUID, as returned by the properties endpoints.

Request

curl "https://api.propaideals.co.uk/api/v1/rental-estimate?property_id=5fa1b2c3-d4e5-6f78-9012-3456789abcde" \
  -H "Authorization: Bearer paid_your_key"

import requests

property_id = "5fa1b2c3-d4e5-6f78-9012-3456789abcde"
res = requests.get(
    "https://api.propaideals.co.uk/api/v1/rental-estimate",
    params={"property_id": property_id},
    headers={"Authorization": "Bearer paid_your_key"},
)
est = res.json()["data"]
print(f"Est. rent £{est['rent_estimate_pcm']:,}/mo, gross yield {est['implied_gross_yield_pct']}%")

const propertyId = "5fa1b2c3-d4e5-6f78-9012-3456789abcde";
const res = await fetch(
  `https://api.propaideals.co.uk/api/v1/rental-estimate?property_id=${propertyId}`,
  { headers: { Authorization: "Bearer paid_your_key" } }
);
const { data } = await res.json();
console.log(`Est. rent £${data.rent_estimate_pcm.toLocaleString()}/mo`);

Response

{
  "data": {
    "property_id": "5fa1b2c3-d4e5-6f78-9012-3456789abcde",
    "rent_estimate_pcm": 1250,
    "sample_size": 23,
    "implied_gross_yield_pct": 6.4,
    "floor_area_sqft": 712,
    "floor_area_source": "measured",
    "price_per_sqft": 301,
    "price_per_sqft_is_estimated": false,
    "price_per_sqft_note": null
  },
  "meta": {
    "usage": {
      "request_cost": 1,
      "monthly_used": 1437,
      "monthly_limit": 20000
    }
  }
}

Response fields

Field	Type	Description
`property_id`	string	The property UUID that was queried.
`rent_estimate_pcm`	number	Estimated monthly rent in £, the median of nearby rental comparables.
`sample_size`	integer	Comparable lets behind the published figure — which pool that is depends on `basis`. For `rent_psf_x_floor_area` it counts only the lets that carry a floor area, the ones the median rent per sqft was measured over; most lets carry none, so this is a fraction of the rung, and it is the same number `notes` quotes. For `rent_psf_clamped_to_band` and `beds_median_rent` the published figure is a statistic of the rung’s whole rent pool, so this counts that pool.
`implied_gross_yield_pct`	number \| null	Annualised gross yield against the property’s listed sale price, or `null` when no sale price is available.
`floor_area_sqft`	number \| null	The subject’s own floor area, the divisor behind `price_per_sqft`.
`floor_area_source`	string	`measured`, `building_estimate`, `unverified` or `absent` — see below.
`price_per_sqft`	number \| null	Listed price ÷ `floor_area_sqft`, in £, truncated to whole pounds. `null` when either input is missing.
`price_per_sqft_is_estimated`	boolean	`true` unless `floor_area_source` is `measured`.
`price_per_sqft_note`	string \| null	Why the figure is qualified, when it is.

The subject’s £/sqft, and why it is qualified

price_per_sqft is published here because this is the only per-property endpoint that already resolves both the floor area and its provenance — so you can put the subject on the same footing as the per-row price_per_sqft on /api/v1/comparables instead of dividing by an unqualified size yourself. Most floor areas come from an EPC certificate, and a certificate is routinely fanned across a whole building: 231,406 of the 595,694 active listings that carry a floor area — 38.9%, measured 2026-08-13 — resolve to a building-level estimate, rising to 43.6% of flats. One block in Canary Wharf had 65 distinct addresses across three bedroom counts all reporting exactly 850 sqft. floor_area_source says which case the subject is in (measured, building_estimate, unverified, absent); price_per_sqft_is_estimated is true for everything except measured. The same provenance also governs the rent basis: a rent per sqft is only applied to a measured area, which is why basis falls back to beds_median_rent otherwise.

How the estimate is built

The estimate is the median of nearby rental comparables, matched within roughly 1 km and within ±1 bedroom of the subject property. The implied gross yield is (rent_estimate_pcm × 12) / listed_sale_price × 100, using the property’s listed sale price when one is available — when it is not, implied_gross_yield_pct is null.

A small sample_size (below ~10) widens the error band on the estimate. For a fuller picture of the comparable set behind the figure, use the comparables endpoint.

Get started

API reference

Granular endpoints

Resources

Rental estimate endpoint

Rental estimate

Query parameters

Request

Response

Response fields

The subject’s £/sqft, and why it is qualified

How the estimate is built

​Rental estimate

​Query parameters

​Request

​Response

​Response fields

​The subject’s £/sqft, and why it is qualified

​How the estimate is built

Rental estimate

Query parameters

Request

Response

Response fields

The subject’s £/sqft, and why it is qualified

How the estimate is built