# UK HMO Licence Full Details by Licence Number

> UK HMO Licence Full Details by Licence Number is a paid API for AI agents from hmo.payapi.market, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Returns full details of a UK HMO licence including licensee, conditions, occupancy limits, and expiry date given a council slug and licence number.

## Facts

- Endpoint: POST https://hmo.payapi.market/hmo-licence-details
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/uk-hmo-licence-full-details-by-licence-number-4198f456
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LRtHo9Wij0JEFj1l_i5zO

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability uk-hmo-licence-full-details-by-licence-number-4198f456 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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).

## Known failure modes

- 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

## How this service works

UK HMO licence full details by licence number. Returns licensee, conditions, occupancy limits, and expiry.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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'."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/uk-hmo-licence-full-details-by-licence-number-4198f456/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hmo.payapi.market](https://www.zero.xyz/host/hmo.payapi.market/llms.txt)