UK HMO Licence API
3 endpoints covering 124,715 licensed rental records across 65 UK councils, as of May 2026: check a single address for HMO status, search all licences in a postcode, and retrieve full licence details including licensee, expiry date, and max occupancy. Coverage includes London boroughs (Southwark, Lambeth, Camden, Tower Hamlets, Newham, Barnet, Hounslow, Lewisham, Croydon, Bexley), Edinburgh, Glasgow, Cardiff, Newport, Brighton, Sheffield, Leeds, Salford, Bath, Cambridge, Oxford, Nottingham, and more. Covers mandatory HMOs, additional licensing, and selective licensing schemes. Essential for letting agents, property buyers, and compliance tools.
x402 verified · $0.02–$0.04 USDC/request · 3 endpoints / 3 tools · Data · base network · x402 protocol
Check whether a UK property is a licensed House in Multiple Occupation (HMO), or list every licensed HMO in a postcode. Backed by 124,715 licence records across 65 councils.
Endpoints
POST /hmo-check: Is this exact property (postcode + house) a licensed HMO? Returns licence number, council, expiry date and maximum occupancy. ($0.02)POST /hmo-by-postcode: List every licensed HMO in a postcode area. ($0.03)POST /hmo-licence-details: Full licence record for a given licence number and council. ($0.04)
Example request
curl -X POST https://hmo.payapi.market/hmo-check \
-H 'content-type: application/json' \
-d '{"postcode":"KT18 7HD","house":"Flat 2"}'
Example response
{
"licensed": true,
"address_matched": "Flat 2, 8-10 Woodcote Side, Epsom, KT18 7HD",
"council": "Epsom and Ewell Borough Council",
"licence_number": "23/00213/HMO",
"expiry_date": "2030-01-13",
"max_occupancy": 5
}
How an agent calls this
Is Flat 2, KT18 7HD a licensed HMO? If so, when does the licence expire and how many occupants is it licensed for?
An MCP-connected agent discovers this API, picks it for the task, and pays per call in USDC. No keys, no account.
How to call this API
Every protected route returns HTTP 402 with x402 payment requirements. An agent pays the stated USDC amount on Base and retries with the payment header. No API keys, no accounts. Browse the marketplace or list your own API.