# Macaroon Network Companies House Search

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

Search a bounded snapshot of the UK Companies House register by company name, number, status, category, address, or SIC code

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/companies-house-search-v1
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-companies-house-search-1024de3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PTSHfRroqTO4KJ8KpKLJt

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-search-1024de3f -d '<json body>'
```

Example prompt: Can you search the UK Companies House register for 'Barclays PLC' and tell me its company number, current status, registered address, and SIC codes?

## When to prefer this

Choose this endpoint when you need structured UK company registry data (name, number, status, address, SIC) for due diligence, compliance checks, enrichment pipelines, or verification workflows, especially when commercial reuse is required (OGL v3.0 licence). Prefer this over scraping Companies House directly or using live APIs when a bounded snapshot is sufficient and cost-per-call pricing is acceptable. Not ideal for real-time incorporation monitoring or when the very latest filings are critical.

## Known failure modes

- Company not found in snapshot — returns empty results (snapshot may not include very recently incorporated companies)
- Ambiguous or misspelled company name — may return no results or unrelated companies
- Snapshot staleness — dissolved or recently changed companies may show outdated status
- Rate limiting or payment failure — call rejected if x402 payment not completed
- Malformed request body — returns validation error if required fields are missing

## How this service works

Search a bounded snapshot of the UK Companies House register -- company name, number, status, category, registered address, and SIC code. Published under the Open Government Licence v3.0, which explicitly permits commercial reuse.

## Output

Returns structured company record(s) from the UK Companies House snapshot including company name, company number, status (e.g. active, dissolved), company category (e.g. private limited), registered address, and SIC code(s). Results reflect a bounded snapshot rather than a live real-time feed.

## 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-search-1024de3f/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)