company_risk_batch

Assess 1–100 companies from structured rows or CSV in one bounded batch, preserving per-row risk results and provider failures.

When to use

Use when an agent needs to screen many companies efficiently instead of making separate risk-report calls.

Selection guidance

Role: specialized. Use when an agent needs to screen many companies efficiently instead of making separate risk-report calls.

Use cases

• batch company screening
• 100 company risk check
• CSV company analysis
• bulk due diligence

Access

• REST: POST https://api.rafidsystem.com/api/v1/risk/company-risk-batch
• x402: POST https://api.rafidsystem.com/api/v1/x402/risk/company-risk-batch
• MCP tool: company_risk_batch

Price: $8.00 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

• business_risk_score
• company_reputation_check
• research_company
• company_risk_report
• due_diligence_oman_company
• analyze_company_risk

Example input

{
  "companies": [
    {
      "companyName": "Example Technologies Ltd",
      "country": "GB",
      "website": "https://example.com"
    },
    {
      "companyName": "Example Trading Ltd",
      "country": "GB"
    }
  ]
}

Example output

{
  "workflow": "company_risk_batch",
  "result": {
    "rows": [],
    "processedCount": 0,
    "successfulCount": 0
  },
  "limitations": [
    "Batch results preserve per-row provider failures and do not make automated approval or rejection decisions."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "companies": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "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
      }
    },
    "csv": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000000
    }
  },
  "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