{"openapi":"3.1.0","info":{"title":"x402 UK Real Estate API","version":"2.0.0","description":"Pay-per-call UK Land Registry sold-price summary by postcode.","x-guidance":"Use GET /sold-prices/{postcode}/summary for a computed sold-price summary (count, min/max/median/avg, date range, property-type breakdown) from HM Land Registry Price Paid Data. You are charged only when there are real transactions to summarise — a postcode with no recorded sales returns 404 and costs nothing.","x-payment-policy":"NEVER CHARGED FOR AN UNDELIVERABLE ANSWER. The x402 middleware cancels settlement for any response >= 400, so every error below moves $0.00 and emits no payment-response header. An empty summary (transactionCount 0, price null) is returned as 404, never as a billed 200.","x-limitations":["Coverage is HM Land Registry Price Paid Data: England & Wales RESIDENTIAL sales since 1995. Scotland, Northern Ireland, commercial property and unsold/listed property are out of scope and will read as no transactions.","This is real comparable sold-price history, not a modelled valuation or AVM estimate."]},"paths":{"/sold-prices/{postcode}/summary":{"get":{"operationId":"soldPricesSummary","summary":"UK postcode sold-price summary","tags":["Data"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"postcode","in":"path","required":true,"schema":{"type":"string"},"description":"UK postcode, e.g. M1 1AE"}],"responses":{"200":{"description":"Sold-price summary computed over at least one real transaction. The only response you are charged for."},"400":{"description":"NOT CHARGED. `invalid_postcode` — the path segment is not a valid UK postcode."},"402":{"description":"Payment Required"},"404":{"description":"NOT CHARGED. `no_transactions_for_postcode` — Land Registry holds no recorded sales for this postcode, so there are no statistics to summarise. `retryable:false`.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","enum":["no_transactions_for_postcode"]},"message":{"type":"string"},"charged":{"type":"boolean","enum":[false]},"retryable":{"type":"boolean","enum":[false]},"postcode":{"type":"string"},"transactionCount":{"type":"integer","enum":[0]}}}}}},"405":{"description":"NOT CHARGED. Wrong HTTP verb for this resource; see the Allow header."},"500":{"description":"NOT CHARGED. `summary_computation_failed` — unexpected internal error."},"502":{"description":"NOT CHARGED. `land_registry_upstream_unavailable` — HM Land Registry did not answer. `retryable:true`."}}}}}}