{"uid":"cap__N6eti5Toae3wsdAN9EXz","slug":"hmo-licenced-properties-by-postcode-ca665dac","name":"HMO Licenced Properties by Postcode","description":"UK licensed HMOs in a postcode area. Returns all licensed Houses in Multiple Occupation registered with the local council.","url":"https://hmo.payapi.market/hmo-by-postcode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"postcode":{"type":"string","description":"UK postcode to search for licensed HMOs in the area."}}},"responseSchema":{"type":"json","example":{"count":2,"council":"Manchester City Council","results":[{"address":"12 Example Road, Manchester, M1 1AE","expiry_date":"2029-03-15","licence_type":"Mandatory","max_occupancy":5,"licence_number":"HMO/2024/00123"},{"address":"14 Example Road, Manchester, M1 1AE","expiry_date":"2028-09-22","licence_type":"Additional","max_occupancy":4,"licence_number":"HMO/2023/00567"}],"postcode":"M1 1AE","data_source":"https://manchester.gov.uk/HMO_register","last_updated":"2026-04-28T09:00:00Z"}},"example":{"request":{"postcode":"SW1A 1AA"},"response":{"count":0,"reason":"no_licences_in_postcode","results":[],"postcode":"SW1A 1AA"}},"exampleRequest":{"postcode":"SW1A 1AA"},"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t9vanxiGGaoF4gyqfWHxx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns all licensed Houses in Multiple Occupation (HMOs) registered with the local council for a given UK postcode area.","exampleAgentPrompt":"Can you find all the licensed HMOs registered in the postcode area SW1A 1AA?","exampleUseCases":[{"title":"Verify neighbourhood rental property standards","prompt":"I'm thinking about moving to the SW1A area - can you check which properties nearby are licensed as HMOs so I know what kind of rental situation I might be moving into?"},{"title":"Screen investment property portfolios","prompt":"I'm looking at buying a house in postcode M1 1AA for a buy-to-let investment. Before I commit, can you show me all the licensed HMO properties in that area so I understand the local rental market better?"},{"title":"Ensure tenant compliance and safety","prompt":"We're letting out a property in postcode B1 1AA and want to make sure we're following all the rules. Can you pull up all the registered HMOs in this postcode so we can see how our property compares to others locally?"}],"resultDescription":"A list of all licensed Houses in Multiple Occupation registered with the local council for the specified UK postcode, including property addresses and licence registration details.","failureModes":["Invalid or malformed UK postcode returns an error or empty result","Postcode not found in the dataset returns an empty list","No licensed HMOs in the area returns an empty array","Network or payment failure returns a non-200 response","Partial postcode provided may return broader or no results"],"whenToPreferThis":"Use this endpoint when you need to discover all HMO-licensed properties within a UK postcode area, such as for tenancy research, compliance checking, neighbourhood analysis, or property investment due diligence. Prefer this over the sibling single-property check when you need a bulk list rather than verifying one specific address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:25.785Z","isFirstParty":false}