company_risk_report

Combine evidence-first public reputation analysis with structured business-risk scoring into one company risk report.

When to use

Use when an agent needs a consolidated company risk report with both evidence and an explicit risk model.

Selection guidance

Role: specialized. Use when an agent needs a consolidated company risk report with both evidence and an explicit risk model.

Use cases

Access

Price: $1.50 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.

Related tools

Example input

{
  "companyName": "Example Technologies Ltd",
  "country": "GB",
  "website": "https://example.com",
  "registrationNumber": "01234567"
}

Example output

{
  "workflow": "company_risk_report",
  "result": {
    "reputation": {},
    "businessRisk": {}
  },
  "limitations": [
    "Risk signals are evidence-backed decision support, not a legal, compliance or transaction decision."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "companyName": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Company name as known to the caller (trading or legal name)."
    },
    "country": {
      "description": "Country of registration/operation — ISO alpha-2 (e.g. GB), alpha-3 or English name. Strongly recommended to avoid same-name confusion.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "website": {
      "description": "Company website, e.g. https://example.com.",
      "type": "string",
      "minLength": 4,
      "maxLength": 300
    },
    "domain": {
      "description": "Company domain if no website URL is known, e.g. example.com.",
      "type": "string",
      "minLength": 3,
      "maxLength": 253
    },
    "registrationNumber": {
      "description": "Company registration number in its home registry (e.g. UK Companies House number).",
      "type": "string",
      "minLength": 2,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 ./-]*$"
    },
    "lei": {
      "description": "Legal Entity Identifier (ISO 17442), if known.",
      "type": "string",
      "minLength": 20,
      "maxLength": 24
    },
    "legalName": {
      "description": "Full registered legal name, if different from companyName.",
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "city": {
      "description": "City of registration/headquarters (helps disambiguation).",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "industry": {
      "description": "Industry/sector (context only; not used to score).",
      "type": "string",
      "minLength": 2,
      "maxLength": 100
    },
    "includeNews": {
      "type": "boolean"
    },
    "includeDigitalSignals": {
      "type": "boolean"
    }
  },
  "required": [
    "companyName"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workflow": {
      "type": "string"
    },
    "result": {},
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "workflow",
    "result",
    "limitations"
  ],
  "additionalProperties": false
}

Category: Company & Risk Intelligence · hierarchy: specialized · idempotent: yes · side effects: no