{"slug":"hmo-licence-report","name":"HMO Licence Report by PayAPI","task":"Full HMO compliance report: licensing verdict, local schemes, room checks, and register lookup for a specific address.","description":"Send the number of occupants, households, sharing status, property address and postcode. Returns everything from HMO Licence Check (national and council licensing schemes, room size pass/fail, fees, next steps) PLUS a register lookup showing whether this exact address holds a licence, its number, type, expiry date and maximum occupancy. Applies fixed rules and queries PayAPI's UK HMO Licence API, which holds the registers councils publish, so a missing match is not proof a property is unlicensed. England only. Information, not legal advice.","category":"Tools","tags":["hmo","hmo licence","landlord","lettings","uk property","compliance","licence register"],"price_usdc":"0.12","price_unit":"per_job","network":"base","asset":"USDC","method":"POST","url":"https://payapi.market/house/agents/hmo-licence-report","uses_model":false,"input_schema":{"type":"object","properties":{"occupants":{"type":"integer","minimum":1,"maximum":50,"description":"People living in the property, counting children."},"households":{"type":"integer","minimum":1,"maximum":50,"description":"Separate households. A couple or a family is one household. Unrelated sharers are one each."},"shares_facilities":{"type":"boolean","description":"True when two or more households share a toilet, bathroom or kitchen."},"property_type":{"type":"string","maxLength":40,"description":"Optional. house, converted_flat or purpose_built_flat.","enum":["house","converted_flat","purpose_built_flat"]},"flats_in_block":{"type":"integer","minimum":1,"maximum":2000,"description":"Optional, for purpose_built_flat only. Self-contained flats in the block."},"nation":{"type":"string","maxLength":20,"description":"Optional. Defaults to england. Other nations are reported as outside scope.","enum":["england","wales","scotland","northern_ireland"]},"licence_held":{"type":"string","maxLength":10,"description":"Optional. Whether an HMO licence is already held: yes, no or unknown.","enum":["yes","no","unknown"]},"council":{"type":"string","maxLength":80,"description":"Optional. Council name. When it matches a covered council, the agent evaluates local schemes and applies council room size standards. Case-insensitive; accepts \"London Borough of X\"."},"ward":{"type":"string","maxLength":80,"description":"Optional. Ward name within the council, for ward-limited schemes."},"address":{"type":"string","maxLength":200,"description":"Required for register lookup. Full property address, for example \"123 High Street\"."},"postcode":{"type":"string","maxLength":10,"description":"Required for register lookup. UK postcode, for example \"SW1A 1AA\"."},"bedrooms":{"type":"array","maxItems":20,"description":"Optional. One entry per bedroom.","items":{"type":"object","properties":{"size_m2":{"type":"number","minimum":1,"maximum":100,"description":"Floor area in square metres."},"occupants_10_plus":{"type":"integer","minimum":0,"maximum":6,"description":"People aged 10 or over sleeping in the room. Defaults to 1."},"children_under_10":{"type":"integer","minimum":0,"maximum":6,"description":"Children under 10 sleeping in the room. Defaults to 0."}},"required":["size_m2"],"additionalProperties":false}}},"required":["occupants","households","shares_facilities","address","postcode"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"verdict":{"type":"string","enum":["mandatory_licence_required","mandatory_licence_likely_confirm_block","licence_required_local_scheme","no_mandatory_licence_check_local_schemes","licence_not_required","not_an_hmo_check_selective","outside_scope"]},"summary":{"type":"string","minLength":1},"is_hmo":{"type":["boolean","null"]},"mandatory_test":{"type":"object","properties":{"occupants":{"type":"integer"},"households":{"type":"integer"},"shares_facilities":{"type":"boolean"},"result":{"type":"string","enum":["applies","likely_applies","does_not_apply","not_assessed"]},"reason":{"type":"string","minLength":1}},"required":["occupants","households","shares_facilities","result","reason"]},"local_schemes":{"oneOf":[{"type":"string","enum":["not_checked"]},{"type":"array","items":{"type":"object","properties":{"scheme_type":{"type":"string","enum":["additional","selective"]},"scope":{"type":"string","enum":["borough_wide","wards"]},"applies":{"type":["boolean","string"],"enum":[true,false,"ward_needed"]},"reason":{"type":"string","minLength":1},"source_url":{"type":"string","minLength":1}},"required":["scheme_type","scope","applies","reason","source_url"]}}]},"council_data":{"oneOf":[{"type":"null"},{"type":"string","enum":["not_covered","stale"]},{"type":"object","properties":{"fees":{"type":"array","items":{"type":"object","properties":{"licence_type":{"type":"string"},"amount_gbp":{"type":"number"},"notes":{"type":"string"},"source_url":{"type":"string"}},"required":["licence_type","amount_gbp","source_url"]}},"licence_length_years":{"type":["number","null"]},"standards_doc_url":{"type":["string","null"]},"room_size_overrides":{"oneOf":[{"type":"null"},{"type":"object","properties":{"one_person_m2":{"type":["number","null"]},"two_person_m2":{"type":["number","null"]},"notes":{"type":"string"},"source_url":{"type":"string"}},"required":["notes","source_url"]}]},"article4_hmo":{"oneOf":[{"type":"null"},{"type":"object","properties":{"applies":{"type":"boolean"},"area_description":{"type":"string"},"source_url":{"type":"string"}},"required":["applies","source_url"]}]},"licensing_page_url":{"type":["string","null"]},"hmo_register_url":{"type":["string","null"]},"last_checked":{"type":"string"}},"required":["fees","licence_length_years","last_checked"]}]},"rooms":{"type":"array","items":{"type":"object","properties":{"room":{"type":"integer"},"size_m2":{"type":"number"},"occupants_10_plus":{"type":"integer"},"children_under_10":{"type":"integer"},"national_minimum_m2":{"type":["number","null"]},"council_minimum_m2":{"type":["number","null"]},"pass":{"type":["boolean","null"]},"note":{"type":"string","minLength":1}},"required":["room","size_m2","note"]}},"register_lookup":{"oneOf":[{"type":"object","properties":{"found":{"type":"boolean","enum":[true]},"address":{"type":"string"},"postcode":{"type":"string"},"council":{"type":"string"},"licence_number":{"type":"string"},"licence_type":{"type":["string","null"]},"max_occupancy":{"type":["integer","null"]},"max_households":{"type":["integer","null"]},"expiry_date":{"type":["string","null"]},"licensee_name":{"type":["string","null"]},"data_source":{"type":"string"},"last_updated":{"type":["string","null"]}},"required":["found","address","postcode","council","data_source"]},{"type":"object","properties":{"found":{"type":"boolean","enum":[false]},"reason":{"type":"string","minLength":1}},"required":["found","reason"]}]},"next_steps":{"type":"array","items":{"type":"string"},"minItems":1},"council":{"type":["string","null"]},"ward":{"type":["string","null"]},"penalty_note":{"type":"string","minLength":1},"rules_as_of":{"type":"string","minLength":1},"sources":{"type":"array","items":{"type":"string"},"minItems":1},"disclaimer":{"type":"string","minLength":1}},"required":["verdict","summary","mandatory_test","local_schemes","rooms","register_lookup","next_steps","penalty_note","rules_as_of","sources","disclaimer"]},"example_request":{"method":"POST","url":"https://payapi.market/house/agents/hmo-licence-report","headers":{"Content-Type":"application/json"},"body":{"occupants":5,"households":3,"shares_facilities":true,"property_type":"house","licence_held":"unknown","council":"Lambeth","ward":"Oval","address":"123 Example Road","postcode":"SW9 1AA","bedrooms":[{"size_m2":8.2},{"size_m2":6.1},{"size_m2":11,"occupants_10_plus":2}]}},"example_response":{"verdict":"mandatory_licence_required","summary":"A mandatory HMO licence is required under the national rules for England.","is_hmo":true,"mandatory_test":{"occupants":5,"households":3,"shares_facilities":true,"result":"applies","reason":"5 people in 3 households sharing facilities is a large HMO. Storeys do not matter."},"local_schemes":[{"scheme_type":"additional","scope":"borough_wide","applies":true,"reason":"Property meets criteria: 5 occupants, 3 households.","source_url":"https://www.lambeth.gov.uk/housing/landlords-licensing/houses-multiple-occupation-hmos/additional-hmo-licensing"},{"scheme_type":"selective","scope":"wards","applies":false,"reason":"Likely covered by HMO licensing instead of selective licensing.","source_url":"https://www.lambeth.gov.uk/housing/landlords-licensing/selective-licensing-scheme"}],"council_data":{"fees":[{"licence_type":"mandatory_and_additional","amount_gbp":550,"notes":"GBP 550 per habitable room or letting (366.67 Part A + 183.33 Part B). GBP 75 discount on Part B for accredited landlords. Effective from 1 April 2026","source_url":"https://www.lambeth.gov.uk/housing/landlords-licensing/houses-multiple-occupation-hmos/licence-other-service-fees"}],"licence_length_years":5,"standards_doc_url":null,"room_size_overrides":null,"article4_hmo":null,"licensing_page_url":"https://www.lambeth.gov.uk/housing/landlords-licensing","hmo_register_url":null,"last_checked":"2026-11-16"},"rooms":[{"room":1,"size_m2":8.2,"occupants_10_plus":1,"children_under_10":0,"national_minimum_m2":6.51,"pass":true,"note":"Using national minimum of 6.51 m2. Meets the national minimum. The council may set a higher figure."},{"room":2,"size_m2":6.1,"occupants_10_plus":1,"children_under_10":0,"national_minimum_m2":6.51,"pass":false,"note":"Using national minimum of 6.51 m2. Below the national minimum of 6.51 m2 for this use."},{"room":3,"size_m2":11,"occupants_10_plus":2,"children_under_10":0,"national_minimum_m2":10.22,"pass":true,"note":"Using national minimum of 10.22 m2. Meets the national minimum. The council may set a higher figure."}],"register_lookup":{"found":false,"reason":"No matching licence in PayAPI's HMO register for this address. The register only holds councils that publish one and can be out of date, so this does not prove the property is unlicensed. Confirm with the council."},"next_steps":["Find out whether a licence is already held. To see whether an address already holds a licence, use the UK HMO Licence API on PayAPI Market: https://payapi.market/api/uk-hmo-licence-api","See Lambeth's property licensing page for full licensing details: https://www.lambeth.gov.uk/housing/landlords-licensing","1 bedroom is below the national minimum. Stop using it for sleeping in that way, or change who sleeps there.","Check the council HMO standards for room sizes, kitchens, bathrooms and fire safety, which are often stricter than the national minimum.","Check whether the address is in an Article 4 area, where a small HMO needs planning permission."],"council":"Lambeth","ward":"Oval","penalty_note":"For offences from 1 May 2026, running a licensable property without a licence can bring a civil penalty of up to GBP 40,000 per offence or prosecution, and a rent repayment order of up to 2 years of rent.","rules_as_of":"2026-11-16","sources":["https://www.gov.uk/government/publications/houses-in-multiple-occupation-and-residential-property-licensing-reform-guidance-for-local-housing-authorities","https://www.legislation.gov.uk/uksi/2018/221/contents/made","https://www.legislation.gov.uk/uksi/2018/616/contents/made","https://england.shelter.org.uk/professional_resources/legal/housing_conditions/hmo_standards/sanctions_for_breaching_hmo_licensing_rules","PayAPI UK HMO Licence API (council HMO registers): https://payapi.market/api/uk-hmo-licence-api"],"disclaimer":"Information from the national rules for England and the details supplied. Not legal advice. Councils run their own licensing schemes, fees and standards, so confirm with the council before acting."}}