# Rafid Company Risk Batch Assessment API

> Rafid Company Risk Batch Assessment API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $8/call, status unknown (last checked 2026-10-10).

Scores and returns structured risk intelligence for a batch of up to 100 companies in a single call, with optional news and digital signals.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/risk/company-risk-batch?utm_source=zero.xyz
- Price: $8/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-company-risk-batch-assessment-api-efd9506d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5bLS8bBh9K0E2dTTB035p

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 rafid-company-risk-batch-assessment-api-efd9506d -d '<json body>'
```

Example prompt: Run a batch risk assessment on these three companies: Acme Logistics Ltd (UK, Companies House number 01234567), Globex Trading GmbH (Germany, domain globextrading.de), and Meridian Supplies Inc (US, website https://meridiansupplies.com) — include news signals for each.

## When to prefer this

Use this endpoint when you need to risk-assess multiple companies in a single API call rather than one at a time — it is purpose-built for batch supplier screening, vendor due diligence, and portfolio counterparty review. Prefer it when you have a list or CSV of companies and need structured, per-row risk intelligence with optional news and digital signal enrichment. It is especially valuable for compliance, procurement, and trading workflows where assessing 2–100 companies simultaneously saves latency and cost compared to serial single-company calls.

## Known failure modes

- Per-row provider failure: individual companies may fail to score while others succeed; failures are preserved in the rows array rather than causing a full batch failure
- Invalid company input: missing required companyName field causes validation error
- Ambiguous company match: same-name companies without country or registration number may return incorrect or low-confidence results
- CSV parse error: malformed CSV input rejected before processing
- Batch size exceeded: more than 100 companies in a single request returns a validation error
- Payment failure: x402 payment of $8 USDC not completed results in 402 response

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

A JSON object containing a 'result' with 'rows' (per-company risk assessment results preserving individual provider successes or failures), 'processedCount' (total companies submitted), and 'successfulCount' (companies successfully scored), plus a 'workflow' identifier and 'limitations' notes indicating no automated approval/rejection decisions are made.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-company-risk-batch-assessment-api-efd9506d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)
