Builds a risk report on up to 5 UK companies by number or name

Builds a risk report on up to 5 UK companies by number or name: Companies House profile, overdue accounts, charges, director history and disqualifications, Gazette insolvency notices and a scored list of red flags with the evidence, optionally as Markdown. Use it before a deal, a supplier contract or credit. $0.50 per company. Runs nerolabs/uk-company-risk-report.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://x402-agent-tools.nerolabs.workers.dev/company/uk-risk-report

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "companies": [
      "00445790"
    ]
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "additionalProperties": false,
          "properties": {
            "checkDirectorHistory": {
              "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.",
              "type": "boolean"
            },
            "checkDisqualifications": {
              "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.",
              "type": "boolean"
            },
            "companies": {
              "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",
              "type": "array"
            },
            "includeGazette": {
              "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",
              "type": "boolean"
            },
            "includeMarkdown": {
              "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.",
              "type": "boolean"
            },
            "maxOfficerChecks": {
              "default": 8,
              "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.",
              "maximum": 25,
              "minimum": 0,
              "type": "integer"
            }
          },
          "required": [
            "companies"
          ],
          "type": "object"
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON