# Nero Labs UK Company Risk Report

> Nero Labs UK Company Risk Report is a paid API for AI agents from x402-agent-tools.nerolabs.workers.dev, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-22).

Builds a scored risk report on up to 5 UK companies using Companies House data, Gazette insolvency notices, director history, and disqualification checks, returning red/amber/green verdicts with evidence.

## Facts

- Endpoint: POST https://x402-agent-tools.nerolabs.workers.dev/company/uk-risk-report?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nero-labs-uk-company-risk-report-940e6d58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oW71gXsJaCr5WK1yi-Av4

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 nero-labs-uk-company-risk-report-940e6d58 -d '<json body>'
```

Example prompt: Can you run a UK company risk report on Carillion plc and HBOS plc before we sign supplier contracts with them? Include Gazette insolvency notices and director history.

## When to prefer this

Use this endpoint when you need a structured, scored risk assessment of UK-registered companies specifically, combining Companies House filings, Gazette insolvency notices, and director vetting in a single call. Prefer this over raw Companies House API calls when you want pre-computed red/amber/green verdicts and evidence-backed flags. Best suited for pre-deal due diligence, supplier screening, credit decisions, or investor checks on UK entities. Not suitable for non-UK companies (use the Irish CRO or Polish KRS sibling endpoints for those jurisdictions).

## Known failure modes

- Company name is ambiguous — returns candidate list instead of report, requiring a more specific name or company number
- Companies House rate limit hit (600 calls per 5 minutes) — director checks may be capped or skipped
- The Gazette rate-limits callers — Gazette insolvency search may be refused and noted in the report
- Company not found on Companies House — outcome field will indicate no match
- Disqualification checks match by name only, so false positives are possible for common director names
- More than 5 companies submitted — likely rejected or only first 5 processed

## How this service works

Pay-per-call tools for AI agents, 31 in all: read web pages and RSS feeds, OCR, PDF text, transcription; email, phone and domain checks; UK, Irish and Polish company lookups and UK risk reports; website contacts, tech stack and SEO audits; PageSpeed; AI review, job post and row enrichment; data cleaning, joins, dedupe and diffs; US and EU compliance rules. No account or API key: pay each call in USDC on Base over x402.

## Output

A JSON array of per-company report rows, each containing: the resolved company name and number, a green/amber/red verdict, counts of red and amber flags, a list of flag objects (code, severity, source, message), full Companies House profile facts (status, incorporation date, SIC codes, registered office, accounts status, charges), previous company names, Gazette insolvency notice results, director appointment and dissolution history, disqualification name-match warnings, a human-readable summary, and optionally a full Markdown report. Ambiguous name searches return candidate lists instead of a full report.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "companies": {
   "type": "array",
   "description": "One entry per company to report on. An 8-character Companies House number (e.g. 00445790) is matched exactly. A name (e.g. \"Carillion plc\") is searched on the register: a unique exact match proceeds to a full report; anything ambiguous returns the candidate list instead, so nothing is reported on th"
  },
  "includeGazette": {
   "type": "boolean",
   "default": true,
   "description": "Searches The Gazette's corporate insolvency notices (winding-up petitions, administrations, liquidations) by the company's exact current and previous names. A winding-up petition appears here before anything changes on Companies House. The Gazette rate-limits callers; if a search is refused the repo"
  },
  "includeMarkdown": {
   "type": "boolean",
   "default": true,
   "description": "Adds a reportMarkdown field with the whole report as readable Markdown, handy for pasting into a CRM note, an email, or an AI agent's context."
  },
  "maxOfficerChecks": {
   "type": "integer",
   "default": 8,
   "maximum": 25,
   "minimum": 0,
   "description": "Caps the per-director appointment and disqualification lookups to keep large companies fast and within the Companies House rate limit (600 calls per 5 minutes). Directors beyond the cap are listed but not cross-checked, and the report says so."
  },
  "checkDirectorHistory": {
   "type": "boolean",
   "default": true,
   "description": "For each active director (up to the limit below), counts their other current appointments and how many of their past companies are dissolved or insolvent, from the Companies House officer appointments endpoint. A director with a long trail of dissolved companies is flagged amber."
  },
  "checkDisqualifications": {
   "type": "boolean",
   "default": true,
   "description": "Searches the Companies House disqualified officers register by each active director's name. A name match is reported as a possible match needing a manual check (amber), never asserted as a confirmed disqualification, because the register is searched by name only."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "facts": {
     "accounts": {
      "nextDue": "2027-08-26",
      "overdue": false,
      "lastType": "group",
      "lastMadeUpTo": "2026-02-28"
     },
     "sicCodes": [
      "47110"
     ],
     "companyName": "TESCO PLC",
     "companyType": "plc",
     "dissolvedOn": null,
     "jurisdiction": "england-wales",
     "companyNumber": "00445790",
     "companyStatus": "active",
     "previousNames": [
      {
       "name": "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
       "ceasedOn": "1983-08-25"
      },
      {
       "name": "TESCO STORES (HOLDINGS) LIMITED",
       "ceasedOn": "1981-12-14"
      }
     ],
     "incorporatedOn": "1947-11-27",
     "registeredOffice": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA, United Kingdom",
     "companyStatusDetail": null,
     "registeredOfficeInDispute": false,
     "undeliverableRegisteredOffice": false
    },
    "flags": [
     {
      "code": "director-dissolved-trail",
      "source": "Companies House",
      "message": "KENNEDY, Christopher John has 20 other appointments at dissolved companies (often routine subsidiary...",
      "severity": "info"
     },
     {
      "code": "director-checks-capped",
      "source": "Companies House",
      "message": "Not every active director was cross-checked (maxOfficerChecks reached).",
      "severity": "info"
     }
    ],
    "input": "00445790",
    "outcome": "report",
    "summary": "TESCO PLC (00445790) is active, incorporated 1947-11-27 (78 years). GREEN: no red or amber flag in t...",
    "verdict": "green",
    "redFlags": 0,
    "checkedAt": "2026-10-21T14:29:20.752Z",
    "amberFlags": 0,
    "companyName": "TESCO PLC",
    "resolvedVia": null,
    "companyNumber": "00445790",
    "companyStatus": "active",
    "companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"
   }
  ],
  "count": 1,
  "_example_note": "Real output, trimmed: long lists cut to their first items, fields and text shortened."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nero-labs-uk-company-risk-report-940e6d58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-tools.nerolabs.workers.dev](https://www.zero.xyz/host/x402-agent-tools.nerolabs.workers.dev/llms.txt)
