# Official Property & Energy Lookups API > Look up UK House Price Index figures, EPA radon zones, HUD FY2027 Fair Market Rents, and the Ofgem domestic energy price cap from vendored official public data. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/property-official - Docs: https://www.brainiac.software/api/property-official/docs - OpenAPI: https://www.brainiac.software/api/property-official/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/property-official/uk-hpi-lookup $0.03 USDC. Return official UK HPI average price, index and change figures for a geography and month from the vendored HM Land Registry full file. Inputs: area, month?, from?, to? Docs: https://www.brainiac.software/api/property-official/docs#property-official-uk-hpi-lookup Example request: ```json { "area": "London", "month": "2026-08" } ``` Example response: ```json { "area": { "name": "London", "code": "E12000007" }, "series": [ { "month": "2026-08", "averagePrice": 554430, "index": 97.1, "indexSA": 95.9, "change1mPct": 0.7, "change12mPct": -2.2, "averagePriceSA": 547678, "salesVolume": null, "byType": { "detached": { "price": 1164439, "index": 99, "change1mPct": -0.1, "change12mPct": 1.8 }, "semiDetached": { "price": 730580, "index": 102.2, "change1mPct": 0.6, "change12mPct": 1.8 }, "terraced": { "price": 648650, "index": 102.6, "change1mPct": 0.8, "change12mPct": 0.1 }, "flat": { "price": 427310, "index": 92.6, "change1mPct": 0.8, "change12mPct": -5 } }, "cash": 583137, "mortgage": 548866, "firstTimeBuyer": 473051, "formerOwnerOccupier": 695762, "newBuild": null, "existing": null } ], "release": "2026-08", "publishedAt": "2026-10-21", "sources": [ { "source": "HM Land Registry UK House Price Index full file (Open Government Licence v3.0)", "url": "https://publicdata.landregistry.gov.uk/market-trend-data/house-price-index-data/UK-HPI-full-file-2026-08.csv", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Figures are from the 2026-08 release (published 2026-10-21); recent months are revised in later releases.", "SalesVolume is often blank for the newest months because sales are registered with a lag.", "…" ] } ``` ### POST /api/v1/property-official/epa-radon-zone-lookup $0.02 USDC. Return the EPA Map of Radon Zones zone (1–3) for a US county from the vendored EPA spreadsheet. Inputs: state, county Docs: https://www.brainiac.software/api/property-official/docs#property-official-epa-radon-zone-lookup Example request: ```json { "state": "CO", "county": "Denver" } ``` Example response: ```json { "matches": [ { "county": "Denver County", "state": "Colorado", "stateCode": "CO", "type": "county", "epaRegion": 8, "zone": 1, "predictedAverage": ">4 pCi/L" } ], "actionLevel": "4 pCi/L (150 Bq/m3)", "sources": [ { "source": "EPA Map of Radon Zones text spreadsheet (September 2025, EPA 402/A-16/001)", "url": "https://www.epa.gov/system/files/documents/2024-05/radon_zones-spreadsheet.xls", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "The EPA map should not be used to determine if individual homes need to be tested; every home should be tested.", "The file has no FIPS codes and uses county names as published (Connecticut uses former counties, not 2022 planning regi…", "…" ] } ``` ### POST /api/v1/property-official/hud-fmr-lookup $0.03 USDC. Return HUD FY2027 Fair Market Rents for a county/town FIPS or HUD area, or Small Area FMRs for a ZIP, from vendored HUD files. Inputs: fips?, hudAreaCode?, zip?, bedrooms?, year? Docs: https://www.brainiac.software/api/property-official/docs#property-official-hud-fmr-lookup Example request: ```json { "zip": "10001" } ``` Example response: ```json { "year": 2027, "effectiveFrom": "2026-10-01", "effectiveTo": "2027-09-30", "zip": "10001", "safmr": [ { "hudAreaCode": "METRO35620MM5600", "hudAreaName": "New York, NY HUD Metro FMR Area", "rent": { "0": 3890, "1": 4100, "2": 4460, "3": 5640, "4": 6190 }, "paymentStandard90": { "0": 3501, "1": 3690, "2": 4014, "3": 5076, "4": 5571 }, "paymentStandard110": { "0": 4279, "1": 4510, "2": 4906, "3": 6204, "4": 6809 } } ], "sources": [ { "source": "HUD FY2027 Small Area Fair Market Rents", "url": "https://www.huduser.gov/portal/datasets/fmr/fmr2027/FY27_safmrs.xlsx", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Values are monthly gross rents in whole USD as published for FY2027 (effective 1 Oct 2026 – 30 Sep 2027).", "The SAFMR file lists 90% and 110% payment-standard values, not PHA-adopted payment standards.", "…" ] } ``` ### POST /api/v1/property-official/ofgem-price-cap-lookup $0.03 USDC. Return the Ofgem GB domestic energy price cap for a region, fuel, meter and payment method for the vendored charge restriction period. Inputs: region, fuel, meter?, paymentMethod?, date?, annualKwh? Docs: https://www.brainiac.software/api/property-official/docs#property-official-ofgem-price-cap-lookup Example request: ```json { "region": "London", "fuel": "electricity", "paymentMethod": "direct-debit", "date": "2026-11-01" } ``` Example response: ```json { "period": { "name": "October 2026 - December 2026", "from": "2026-10-01", "to": "2026-12-31" }, "region": "London", "fuel": "electricity", "meter": "single-rate", "paymentMethod": "direct-debit", "exVat": { "nilAnnual": 156.64, "benchmarkAnnual": 821.53, "benchmarkKwh": 2500, "standingChargePencePerDay": 42.92, "unitRatePencePerKwh": 26.6 }, "vatRate": 0, "incVat": { "nilAnnual": 156.64, "benchmarkAnnual": 821.53, "benchmarkKwh": 2500, "standingChargePencePerDay": 42.92, "unitRatePencePerKwh": 26.6 }, "sources": [ { "source": "Ofgem Annex 9 Levelisation allowance methodology and levelised cap levels v1.11", "url": "https://www.ofgem.gov.uk/sites/default/files/2026-08/Annex-9-Levelisation-allowance-methodology-and-levelised-cap-level…", "retrievedAt": "2026-11-15", "status": "ok" }, { "source": "Ofgem 17a PDF Cap Tables", "url": "https://www.ofgem.gov.uk/sites/default/files/2026-08/17a-PDF-Cap-Tables.pdf", "retrievedAt": "2026-11-15", "status": "ok" } ], "limitations": [ "Only charge restriction period October 2026 - December 2026 is vendored (published 2026-08-26).", "For multi-register meters the unit rate is a single blended rate across registers (Ofgem does not split the cap by regi…", "…" ] } ```