{"uid":"cap_sp9tT_vaxe2U1mbuqANu2","slug":"property-payapi-market-f7e1726d","name":"UK Rental Yield Estimator by Postcode","description":"Estimated rental yield for a UK postcode.","url":"https://property.payapi.market/yield-estimate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"postcode":{"type":"string","description":"UK postcode."},"property_value":{"type":"number","description":"Property value in GBP. If omitted, the API uses the average recent sold price for the postcode."}}},"responseSchema":null,"example":{"request":{"postcode":"SW1A 1AA","property_value":450000},"response":{"cached":false,"postcode":"SW1A 1AA","yield_band":"Average (4–6%)","property_value":450000,"gross_yield_percent":5.6,"estimated_annual_rent":25200,"estimated_monthly_rent":2100}},"exampleRequest":{"postcode":"SW1A 1AA","property_value":450000},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JAHao6iWsdusXRci9TGRi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Estimates the rental yield for a UK property given a postcode and optional property value in GBP.","exampleAgentPrompt":"What's the estimated rental yield for a property in the E1 6RF postcode worth £450,000?","exampleUseCases":null,"resultDescription":"Returns an estimated rental yield percentage for the specified UK postcode, taking into account the provided property value or the average recent sold price for that postcode if no value is given. May include annualised rental income figures and yield breakdown.","failureModes":["Invalid or unrecognised UK postcode returns an error response","Property value provided as non-numeric or negative triggers validation error","Postcode outside England and Wales may not be supported","Payment not included or insufficient results in HTTP 402 Payment Required","Service unavailable or timeout for unknown postcodes with no sold price history"],"whenToPreferThis":"Use this endpoint when you need a quick, data-driven rental yield estimate for a specific UK postcode, especially when evaluating buy-to-let investment opportunities or comparing rental returns across locations. Ideal when you have a known property value or want to rely on average market data for a postcode.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:50.501Z","isFirstParty":false}