# Rafid Business Due Diligence API

> Rafid Business Due Diligence API is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $2/call, status unknown (last checked 2026-10-10).

Returns structured due diligence intelligence on an Omani company including registration details, risk assessment, procurement history, and source-verified verification status for a given transaction type and value.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/business/due-diligence?utm_source=zero.xyz
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-business-due-diligence-api-4d27b917
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RJTsp5vg6vvQZjTR5535c

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-business-due-diligence-api-4d27b917 -d '<json body>'
```

Example prompt: Can you run a due diligence check on Omani company ID 'demo-co-1' before we sign a supplier contract worth 50,000 OMR? I need their registration status, risk level, and any procurement flags.

## When to prefer this

Use this endpoint when you need structured, source-attributed due diligence on companies operating in Oman, especially for supplier contracting, partnership evaluation, investment screening, or credit decisions. Prefer this over generic company lookup APIs when you need Oman-specific registry data, government procurement presence, and transaction-type-aware risk scoring with OMR-denominated value context.

## Known failure modes

- Invalid or unknown companyId returns low-confidence or empty company record
- Demo data returns low sourceAuthority (0.1) and confidence (~0.34) indicating unverified results
- transactionValueOMR exceeding 1,000,000,000 is rejected by schema validation
- Missing required fields (companyId or transactionType) result in a validation error
- Real registry sources unavailable may result in dataCoverage.realSources = 0 and latestVerifiedAt = null
- Payment failure (insufficient USDC) will block the API call via x402 protocol

## 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

Returns a JSON object containing: full company profile (name, legal type, address, registration number, industry, status), risk assessment (risk level, risk score, risk flags), procurement history (government tender participation, awarded contracts, supplier category), verification details (identity verified, tax status, registration age), confidence score with reasons, and a list of sources with their authority scores and verification status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "companyId": {
   "type": "string",
   "maxLength": 120,
   "minLength": 1
  },
  "transactionType": {
   "enum": [
    "supplier_contract",
    "partnership",
    "investment",
    "customer_credit",
    "other"
   ],
   "type": "string"
  },
  "transactionValueOMR": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "company": {
   "email": "sales@alnoortrading.om",
   "phone": "+968 2440 1234",
   "status": "active",
   "address": "Ghala Industrial Area, Muscat",
   "website": "https://alnoortrading.om",
   "wilayat": "Muscat",
   "industry": "Trading",
   "companyId": "demo-co-1",
   "legalType": "LLC",
   "activities": [
    "General trading",
    "Import and export"
   ],
   "companyName": "Al Noor Trading LLC",
   "governorate": "Muscat",
   "registrationDate": "2015-04-10",
   "registrationNumber": "1010123456"
  },
  "sources": [
   {
    "fields": [
     "companyName",
     "normalizedName",
     "registrationNumber",
     "legalType",
     "status",
     "industry",
     "governorate",
     "wilayat",
     "area",
     "website",
     "email",
     "phone"
    ],
    "sourceUrl": "https://alnoortrading.om/about",
    "observedAt": "2026-09-11",
    "sourceName": "alnoortrading.om (demo)",
    "sourceType": "demo",
    "sourceRecordId": null,
    "sourceAuthority": 0.1,
    "verificationStatus": "unknown"
   },
   {
    "fields": [
     "registrationDate",
     "activities",
     "address",
     "vatNumber",
     "vatStatus",
     "employeeRange",
     "estimatedCompanySize"
    ],
    "sourceUrl": "https://example-registry.om/companies/1010123456",
    "observedAt": "2026-08-07",
    "sourceName": "Oman Ministry of Commerce, Industry and Investment Promotion (demo)",
    "sourceType": "demo",
    "sourceRecordId": "MOCIIP-1010123456",
    "sourceAuthority": 0.1,
    "verificationStatus": "unknown"
   }
  ],
  "confidence": 0.34,
  "procurement": {
   "awards": [],
   "supplierCategory": null,
   "registeredSupplier": null,
   "tendersParticipated": null,
   "awardedContractCount": null,
   "lastTenderActivityAt": null,
   "supplierClassification": null,
   "governmentProcurementPresence": null
  },
  "dataCoverage": {
   "demoSources": 2,
   "realSources": 0,
   "latestVerifiedAt": null
  },
  "verification": {
   "status": "active",
   "taxVerifiedAt": null,
   "lastVerifiedAt": null,
   "identityVerified": false,
   "verificationStatus": "unknown",
   "registrationAgeYears": 11,
   "taxVerificationStatus": null
  },
  "riskAssessment": {
   "riskFlags": [],
   "riskLevel": "low",
   "riskScore": 0
  },
  "confidenceReasons": [
   "This record is backed only by the curated demo dataset — not a real registry, website or directory source.",
   "2 distinct source(s) contributed to this record (target is 3+ for full confidence 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-business-due-diligence-api-4d27b917/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)