{"uid":"cap_LRtHo9Wij0JEFj1l_i5zO","slug":"uk-hmo-licence-full-details-by-licence-number-4198f456","name":"UK HMO Licence Full Details by Licence Number","description":"UK HMO licence full details by licence number. Returns licensee, conditions, occupancy limits, and expiry.","url":"https://hmo.payapi.market/hmo-licence-details","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"council":{"type":"string","description":"Council slug, e.g. 'manchester', 'birmingham', 'newham'."},"licence_number":{"type":"string","description":"HMO licence reference number, e.g. 'HMO/2024/00123'."}}},"responseSchema":{"type":"json","example":{"address":"12 Example Road, Manchester, M1 1AE","council":"Manchester City Council","conditions":"Annual gas safety check required. Smoke alarms on every storey.","start_date":"2024-03-15","data_source":"https://manchester.gov.uk/HMO_register","expiry_date":"2029-03-15","last_updated":"2026-04-28T09:00:00Z","licence_type":"Mandatory","licensee_name":"Individual Landlord","max_occupancy":5,"licence_number":"HMO/2024/00123","max_households":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A0oadlm2fl8Al2Czq97Lr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns full details of a UK HMO licence including licensee, conditions, occupancy limits, and expiry date given a council slug and licence number.","exampleAgentPrompt":"Can you pull up the full licence details for HMO licence number HMO/2024/00123 from Manchester council — I need the licensee name, any conditions, occupancy limit, and when it expires.","exampleUseCases":null,"resultDescription":"A structured record containing the HMO licence holder (licensee) name and contact details, all conditions attached to the licence, the maximum permitted occupancy for the property, and the licence expiry date, sourced from the specified UK council's HMO register.","failureModes":["Licence number not found for the given council — returns 404 or empty result","Invalid council slug provided — returns 400 bad request","Licence number format is malformed — returns 400 validation error","Council data not yet integrated — returns 404 or unsupported council error","Payment failure via x402 protocol — returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you have a specific HMO licence reference number and need the full structured record including licensee, conditions, occupancy limits, and expiry — as opposed to checking whether a property is licensed (use the postcode/house number endpoint) or listing all HMOs in an area (use the postcode area endpoint).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:37:07.956Z","isFirstParty":false}