# HMO Licenced Properties by Postcode

> HMO Licenced Properties by Postcode is a paid API for AI agents from hmo.payapi.market, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).

Returns all licensed Houses in Multiple Occupation (HMOs) registered with the local council for a given UK postcode area.

## Facts

- Endpoint: POST https://hmo.payapi.market/hmo-by-postcode
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hmo-licenced-properties-by-postcode-ca665dac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__N6eti5Toae3wsdAN9EXz

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 hmo-licenced-properties-by-postcode-ca665dac -d '<json body>'
```

Example prompt: Can you find all the licensed HMOs registered in the postcode area SW1A 1AA?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

UK licensed HMOs in a postcode area. Returns all licensed Houses in Multiple Occupation registered with the local council.

## Output

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.

## Example request

```json
{
 "postcode": "SW1A 1AA"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "postcode": {
   "type": "string",
   "description": "UK postcode to search for licensed HMOs in the area."
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hmo-licenced-properties-by-postcode-ca665dac/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)