# Macaroon Network – Companies House Live Discovery

> Macaroon Network – Companies House Live Discovery is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Searches the official UK Companies House register using advanced filters to return up to 20 normalized company records matching name, status, type, incorporation date range, location, and SIC code.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/companies-house-live-discovery-v1
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-companies-house-live-discovery-61c08529
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lY1wkcxF24GmHIkTPjasR

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 macaroon-network-companies-house-live-discovery-61c08529 -d '<json body>'
```

Example prompt: Search Companies House for active private limited companies in London with SIC code 62012 that were incorporated between January 2020 and December 2022 and whose name includes 'tech'.

## When to prefer this

Choose this endpoint when you need to discover or enumerate UK companies using multiple combined filters (name fragment, status, type, date range, location, SIC code) against the live Companies House register. It is ideal for market research, competitor discovery, due diligence screening, and regulatory lookups where official UK government data is required. Prefer this over a simple name-lookup endpoint when you need to filter by industry sector (SIC), geography, or incorporation date simultaneously.

## Known failure modes

- No matching companies found for the given filter combination — returns empty result set
- Invalid or unsupported SIC code returns an error or empty results
- Date range outside valid bounds may cause a validation error
- Overly broad queries may be capped at 20 results with no pagination
- Payment failure via x402 protocol results in a 402 response and no data returned
- Malformed body or missing required fields returns a 400-level error

## How this service works

Discover current UK companies through the official Companies House advanced search using bounded filters for company-name inclusion, status, type, incorporation date range, location, and five-digit SIC code. Returns at most 20 normalized company-level public-register records.

## Output

Returns up to 20 normalized company-level records from the UK Companies House public register, each containing the company name, company number, status (e.g. active, dissolved), company type, incorporation date, registered office address, and SIC code(s).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macaroon-network-companies-house-live-discovery-61c08529/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)