POST /api/rental-appraisal/

Rental valuation API

Market rent for a home, with a likely range and the nearby lettings behind it. Send a UPRN and receive JSON for your rent-setting tool, portfolio model or landlord report.

Get an API key → See the request ↓

1,000 tokens (£10 + VAT) per appraisal

Rental market appraisal

Harvey Lane, Norwich NR7

4-bedroom house · house number withheld

Appraised 22 Oct 2026

Market rent £1,490pcm £344 pw

Affordable rent · 80% £1,192pcm £275 pw

80% £1,270 £2,070

Likely range: £1,270 to £2,070
Confidence: Medium
Evidence: 100 lettings within 1.7 miles

Nearest comparables

DistancePostcodeRent pcmWeight

0.12 mi NR1 4PU £1,250 12.2%

0.18 mi NR1 4JY £1,295 12.2%

0.26 mi NR7 9NR £1,500 11.6%

0.42 mi NR7 0BE £1,400 4.3%

0.43 mi NR1 4JR £1,400 4.0%

0.44 mi NR1 4JR £1,395 3.9%

And 94 more 4-bedroom houses advertised to let nearby. The nearest 6 carry 48% of the estimate.

Request and response

Call the rental appraisal endpoint

Create an API key, add tokens, then replace YOUR_UPRN with the home’s UPRN. The sample home’s identifier is withheld.

curl -X POST 'https://api.homedata.co.uk/api/rental-appraisal/' \
  -H 'Authorization: Api-Key YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"uprn": "YOUR_UPRN"}'

You can also send address_line_1 and postcode, or lat and lng with beds and type (house, flat or room). A postcode alone does not identify a home.

The sample home’s response

Selected fields from the live capture on 22 Oct 2026. Subject identifiers and the comparables array are omitted here.

{
    "estimate_pcm": 1490,
    "low_pcm": 1270,
    "high_pcm": 2070,
    "confidence": "medium",
    "comparables_used": 100,
    "radius_mi": 4,
    "distance_breakdown": {
        "within_0_25mi": 2,
        "within_0_5mi": 6,
        "within_1mi": 25,
        "within_2mi": 100,
        "beyond_2mi": 0
    },
    "as_of": "2026-10-22",
    "data_as_of": "2026-10-22",
    "method": "rmas-v1"
}

Authentication and API docs → Explore the API playground →

The playground lets you explore the API catalogue; use the POST request above for a rental appraisal.

What the fields mean

subject: The home identified by your request, with its location, bedrooms and property type. Not reproduced in this public sample.
estimate_pcm: Estimated market rent in pounds per calendar month. Multiply by 12 and divide by 52 to calculate weekly rent.
low_pcm / high_pcm: Lower and upper bounds of the likely monthly rent range. The range is calibrated to contain about 80% of known asking rents in leave-one-out tests; it is not a guaranteed letting price.
confidence: How closely the comparable rents agree. This sample returned medium.
comparables_used: Number of comparable lettings used to estimate the rent, up to 100.
radius_mi: Search radius in miles. This is not the distance to the farthest comparable actually used.
distance_breakdown: Comparable counts within each distance threshold. The within counts are cumulative; beyond_2mi counts those farther than two miles.
sd_within_0_25mi: Spread of comparable monthly rents within a quarter mile, expressed as a standard deviation in pounds. A small local sample needs care when interpreting it.
as_of / data_as_of: The appraisal date and the date of the underlying data. Keep both with any saved report.
method: Method version used for the appraisal, so you can identify how a saved result was produced.
comparables[]: Evidence for the estimate: each comparable’s rent_pcm, postcode, type, beds, distance_mi and weight. first_seen and last_seen describe listing observations, not tenancy dates. thumbnail_url can be null. Keep your interface usable without a photo.

These are estimates from advertised rents, rather than agreed tenancy rents. Review the evidence before setting a rent.

Price per appraisal

1,000 tokens (£10 + VAT) per home, paid from your token balance. A home we cannot appraise is not charged.

Token pricing →Get an API key →

Not technical? Download the report

Get a finished Homedata report: an interactive web report you can adjust, and a PDF ready for a board, a landlord or the rent file. The previews below show another sample home. Pick the home, and the report is ready in seconds.