company_due_diligence

Perform company due diligence for onboarding, procurement, partnership, investment or customer-risk decisions: resolve the entity, evaluate registration, website identity, sanctions, adverse news, legal, financial and reputation signals, then return a deterministic risk assessment with evidence and a machine-actionable next action.

When to use

Use when an autonomous agent must decide whether to continue doing business with a company and what verification or escalation should happen next.

Selection guidance

Role: primary. before onboarding a supplier; before signing a commercial agreement; before paying an unfamiliar company

Not for: simple company search; stock price lookup; basic website lookup

Use cases

• supplier onboarding
• vendor review
• procurement
• partnership screening
• investment screening
• marketplace onboarding
• customer risk

Access

• REST: POST https://api.rafidsystem.com/api/v1/risk/company-due-diligence
• x402: POST https://api.rafidsystem.com/api/v1/x402/risk/company-due-diligence
• MCP tool: company_due_diligence
• Free preview: POST https://api.rafidsystem.com/api/v1/preview/company_due_diligence

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

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

Example input

{
  "company": "Example Trading Ltd",
  "domain": "example.com",
  "country": "GB",
  "purpose": "supplier_onboarding"
}

Example output

{
  "success": true,
  "company": {
    "name": "Example Trading Ltd",
    "domain": "example.com",
    "country": "GB",
    "registrationNumber": null
  },
  "purpose": "supplier_onboarding",
  "depth": "standard",
  "checks": {
    "registry": true,
    "sanctions": true,
    "adverseMedia": true,
    "reputation": true,
    "businessRisk": true
  },
  "entityResolution": {
    "status": "unresolved",
    "confidence": 0,
    "matchedIdentifiers": [],
    "candidateCount": 0
  },
  "registrationCheck": {
    "success": true,
    "data": {
      "status": "unknown",
      "legalName": null,
      "registrationNumber": null,
      "jurisdiction": null,
      "incorporationDate": null,
      "source": null
    }
  },
  "sanctionsCheck": {
    "success": true,
    "data": {
      "status": "not_checked",
      "matches": [],
      "listsChecked": [],
      "listsUnavailable": []
    }
  },
  "adverseMediaCheck": {
    "success": true,
    "data": {
      "articlesChecked": 0,
      "negativeArticles": 0,
      "materialFindings": [],
      "riskScore": 0,
      "riskLevel": "low",
      "confidence": 0
    }
  },
  "reputationCheck": {
    "success": false,
    "error": {
      "code": "NOT_CHECKED",
      "message": "Reputation check disabled by request."
    }
  },
  "businessRiskCheck": {
    "success": true,
    "data": {}
  },
  "entityMatch": {
    "status": "unverified",
    "confidence": 0,
    "matchedOn": []
  },
  "registration": {
    "status": "not_verified",
    "incorporatedAt": null,
    "source": null
  },
  "websiteSignals": {
    "domainAgeYears": null,
    "ssl": null,
    "businessIdentityMatch": null,
    "confidence": 0
  },
  "management": [],
  "sanctions": {
    "status": "not_checked",
    "matches": [],
    "listsChecked": [],
    "listsUnavailable": []
  },
  "legalSignals": [],
  "negativeNews": {
    "materialCount": 0,
    "items": []
  },
  "financialSignals": {
    "status": "unavailable",
    "signals": []
  },
  "reputation": {
    "score": null,
    "risk": null
  },
  "riskScore": null,
  "riskLevel": null,
  "confidence": 0,
  "riskBreakdown": {
    "identity": null,
    "registration": null,
    "sanctions": null,
    "legal": null,
    "negativeNews": null,
    "financial": null,
    "reputation": null
  },
  "redFlags": [],
  "recommendation": "insufficient_data",
  "reasonCodes": [
    "INSUFFICIENT_DATA"
  ],
  "sources": [],
  "decision": {
    "action": "insufficient_data",
    "requiresHumanReview": false
  },
  "evidence": [],
  "coverage": {
    "registration": "not_checked",
    "website": "not_checked",
    "sanctions": "not_checked",
    "negativeNews": "not_checked",
    "financial": "unavailable"
  },
  "providers": [],
  "generatedAt": "2026-01-01T00:00:00.000Z"
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Company legal or trading name."
    },
    "domain": {
      "description": "Public company domain, without credentials or a private/localhost host.",
      "type": "string",
      "minLength": 3,
      "maxLength": 253
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "registrationNumber": {
      "type": "string",
      "minLength": 2,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9][A-Za-z0-9 ./-]*$"
    },
    "purpose": {
      "default": "general_due_diligence",
      "type": "string",
      "enum": [
        "supplier_onboarding",
        "vendor_review",
        "procurement",
        "partnership",
        "investment_screening",
        "marketplace_onboarding",
        "customer_risk",
        "general_due_diligence"
      ]
    },
    "depth": {
      "default": "standard",
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "enhanced"
      ]
    },
    "checks": {
      "default": {
        "registry": true,
        "sanctions": true,
        "adverseMedia": true,
        "reputation": true,
        "businessRisk": true
      },
      "type": "object",
      "properties": {
        "registry": {
          "default": true,
          "type": "boolean"
        },
        "sanctions": {
          "default": true,
          "type": "boolean"
        },
        "adverseMedia": {
          "default": true,
          "type": "boolean"
        },
        "reputation": {
          "default": true,
          "type": "boolean"
        },
        "businessRisk": {
          "default": true,
          "type": "boolean"
        }
      },
      "required": [
        "registry",
        "sanctions",
        "adverseMedia",
        "reputation",
        "businessRisk"
      ],
      "additionalProperties": false
    },
    "lei": {
      "type": "string",
      "minLength": 20,
      "maxLength": 24
    }
  },
  "required": [
    "company",
    "purpose",
    "depth",
    "checks"
  ],
  "additionalProperties": false,
  "description": "Strict company due diligence request. Unknown fields are rejected."
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "const": true
    },
    "company": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "domain": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": [
            "string",
            "null"
          ]
        },
        "registrationNumber": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "domain",
        "country",
        "registrationNumber"
      ],
      "additionalProperties": false
    },
    "purpose": {
      "type": "string"
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "enhanced"
      ]
    },
    "checks": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "boolean"
      }
    },
    "entityResolution": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "resolved",
            "ambiguous",
            "unresolved"
          ]
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "matchedIdentifiers": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "candidateCount": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        }
      },
      "required": [
        "status",
        "confidence",
        "matchedIdentifiers",
        "candidateCount"
      ],
      "additionalProperties": false
    },
    "registrationCheck": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {},
        "error": {}
      },
      "required": [
        "success"
      ],
      "additionalProperties": false
    },
    "sanctionsCheck": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {},
        "error": {}
      },
      "required": [
        "success"
      ],
      "additionalProperties": false
    },
    "adverseMediaCheck": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {},
        "error": {}
      },
      "required": [
        "success"
      ],
      "additionalProperties": false
    },
    "reputationCheck": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {},
        "error": {}
      },
      "required": [
        "success"
      ],
      "additionalProperties": false
    },
    "businessRiskCheck": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "data": {},
        "error": {}
      },
      "required": [
        "success"
      ],
      "additionalProperties": false
    },
    "entityMatch": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "matched",
            "probable",
            "unverified"
          ]
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        },
        "matchedOn": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "status",
        "confidence",
        "matchedOn"
      ],
      "additionalProperties": false
    },
    "registration": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "active",
            "inactive",
            "dissolved",
            "liquidation",
            "unknown",
            "not_verified"
          ]
        },
        "incorporatedAt": {
          "type": [
            "string",
            "null"
          ]
        },
        "source": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "status",
        "incorporatedAt",
        "source"
      ],
      "additionalProperties": false
    },
    "websiteSignals": {
      "type": "object",
      "properties": {
        "domainAgeYears": {
          "anyOf": [
            {
              "type": "number",
              "minimum": 0
            },
            {
              "type": "null"
            }
          ]
        },
        "ssl": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "businessIdentityMatch": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "confidence": {
          "type": "number",
          "minimum": 0,
          "maximum": 1
        }
      },
      "required": [
        "domainAgeYears",
        "ssl",
        "businessIdentityMatch",
        "confidence"
      ],
      "additionalProperties": false
    },
    "management": {
      "type": "array",
      "items": {}
    },
    "sanctions": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "clear",
            "potential_match",
            "confirmed_match",
            "not_checked",
            "unavailable"
          ]
        },
        "matches": {
          "type": "array",
          "items": {}
        },
        "listsChecked": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "listsUnavailable": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "status",
        "matches",
        "listsChecked",
        "listsUnavailable"
      ],
      "additionalProperties": false
    },
    "legalSignals": {
      "type": "array",
      "items": {}
    },
    "negativeNews": {
      "type": "object",
      "properties": {
        "materialCount": {
          "type": "integer",
          "minimum": 0,
          "maximum": 9007199254740991
        },
        "items": {
          "type": "array",
          "items": {}
        }
      },
      "required": [
        "materialCount",
        "items"
      ],
      "additionalProperties": false
    },
    "financialSignals": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "available",
            "limited_data",
            "unavailable"
          ]
        },
        "signals": {
          "type": "array",
          "items": {}
        }
      },
      "required": [
        "status",
        "signals"
      ],
      "additionalProperties": false
    },
    "reputation": {
      "type": "object",
      "properties": {
        "score": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "risk": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "low",
                "moderate",
                "high",
                "critical"
              ]
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "score",
        "risk"
      ],
      "additionalProperties": false
    },
    "riskScore": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        {
          "type": "null"
        }
      ]
    },
    "riskLevel": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "low",
            "moderate",
            "high",
            "critical"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "riskBreakdown": {
      "type": "object",
      "properties": {
        "identity": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "registration": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "sanctions": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "legal": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "negativeNews": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "financial": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        },
        "reputation": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "identity",
        "registration",
        "sanctions",
        "legal",
        "negativeNews",
        "financial",
        "reputation"
      ],
      "additionalProperties": false
    },
    "redFlags": {
      "type": "array",
      "items": {}
    },
    "recommendation": {
      "type": "string",
      "enum": [
        "proceed",
        "proceed_with_standard_checks",
        "manual_review_required",
        "enhanced_due_diligence_required",
        "reject_counterparty",
        "insufficient_data"
      ]
    },
    "reasonCodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sources": {
      "type": "array",
      "items": {}
    },
    "decision": {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "enum": [
            "continue_onboarding",
            "continue_with_enhanced_checks",
            "request_additional_documents",
            "manual_review_required",
            "reject_due_to_sanctions",
            "reject_due_to_identity_mismatch",
            "reject_due_to_material_risk",
            "insufficient_data"
          ]
        },
        "requiresHumanReview": {
          "type": "boolean"
        }
      },
      "required": [
        "action",
        "requiresHumanReview"
      ],
      "additionalProperties": false
    },
    "evidence": {
      "type": "array",
      "items": {}
    },
    "coverage": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string",
        "enum": [
          "complete",
          "partial",
          "unavailable",
          "not_checked"
        ]
      }
    },
    "providers": {
      "type": "array",
      "items": {}
    },
    "generatedAt": {
      "type": "string"
    }
  },
  "required": [
    "success",
    "company",
    "purpose",
    "depth",
    "checks",
    "entityResolution",
    "registrationCheck",
    "sanctionsCheck",
    "adverseMediaCheck",
    "reputationCheck",
    "businessRiskCheck",
    "entityMatch",
    "registration",
    "websiteSignals",
    "management",
    "sanctions",
    "legalSignals",
    "negativeNews",
    "financialSignals",
    "reputation",
    "riskScore",
    "riskLevel",
    "confidence",
    "riskBreakdown",
    "redFlags",
    "recommendation",
    "reasonCodes",
    "sources",
    "decision",
    "evidence",
    "coverage",
    "providers",
    "generatedAt"
  ],
  "additionalProperties": false
}

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