oman_supplier_check

Screen an Oman supplier for procurement using company identity, business activity, website, contact consistency, address signals, public-risk indicators and sanctions screening.

When to use

Use before adding an Oman supplier to an RFQ, vendor shortlist, procurement process or supplier onboarding workflow.

Selection guidance

Role: primary. screening an Oman supplier before an RFQ or onboarding; identity, activity and contact consistency checks

Not for: global company screening; a final procurement approval; finding suppliers from scratch

Use cases

Access

Price: $0.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 Technical Services LLC",
  "website": "https://example.om",
  "email": "sales@example.om",
  "requiredProductOrService": "HVAC maintenance"
}

Example output

{
  "supplier": {
    "inputName": "Example Technical Services LLC",
    "normalizedName": "EXAMPLE TECHNICAL SERVICES",
    "matchedName": null,
    "matchedNameAr": null,
    "companyId": null,
    "crNumber": null,
    "crNumberSupplied": null,
    "country": "OM",
    "identityMatch": "unconfirmed"
  },
  "screeningResult": {
    "risk": "insufficient_data",
    "riskScore": 0,
    "procurementSuitability": "insufficient_information",
    "identityConfirmed": false,
    "activityMatch": null,
    "summary": "There is not enough public evidence to screen this supplier (risk: insufficient_data; identity evidence: unconfirmed)."
  },
  "checks": {
    "companyIdentity": {
      "status": "unknown",
      "confidence": 0,
      "explanation": "No record in Rafid Oman company registry — Composite(Licensed Oman business-data feed (not yet integrated), Rafid curated Oman business demo dataset (demo/MVP)) matched the submitted company name. This is not evidence that the company does not exist — registry coverage is incomplete.",
      "corroborations": []
    },
    "website": {
      "status": "unknown",
      "explanation": "A website (https://example.om) was supplied, but live website inspection is not enabled for this deployment.",
      "url": "https://example.om",
      "urlSource": "supplied",
      "signals": {
        "websiteExists": null,
        "https": null,
        "domainMatchesCompanyName": null,
        "domainMatchesRegistry": null,
        "companyNameOnWebsite": null,
        "corporateEmailOnWebsite": null,
        "phoneOnWebsite": null,
        "physicalAddressOnWebsite": null,
        "redirectedToDifferentDomain": null
      }
    },
    "businessActivity": {
      "status": "unknown",
      "explanation": "No registry activity or website content was available to compare against the requested product/service.",
      "requiredCategories": [
        "hvac"
      ],
      "supplierCategories": []
    },
    "contactConsistency": {
      "status": "pass",
      "explanation": "email domain matches supplied website."
    },
    "addressConsistency": {
      "status": "unknown",
      "explanation": "No address was supplied, so address consistency was not assessed."
    },
    "sanctions": {
      "status": "not_checked",
      "matches": [],
      "listsChecked": [],
      "listsUnavailable": [],
      "explanation": "No sanctions source is enabled for this deployment; sanctions were not screened."
    },
    "publicRisk": {
      "status": "not_checked",
      "signals": [],
      "explanation": "Public-web risk screening is not enabled for this deployment; only internal consistency indicators were evaluated."
    }
  },
  "riskFlags": [
    {
      "code": "IDENTITY_NOT_CONFIRMED",
      "severity": "low",
      "message": "No registry record could be confidently matched to the submitted company."
    },
    {
      "code": "INSUFFICIENT_PUBLIC_DATA",
      "severity": "low",
      "message": "Too little public evidence was available to screen this supplier reliably."
    }
  ],
  "riskModel": {
    "score": 0,
    "thresholds": {
      "medium": 20,
      "high": 45
    },
    "components": []
  },
  "normalizedInput": {
    "companyName": "Example Technical Services LLC",
    "normalizedName": "EXAMPLE TECHNICAL SERVICES",
    "nameVariants": [
      "EXAMPLE TECHNICAL SERVICES"
    ],
    "crNumber": null,
    "website": "https://example.om",
    "websiteDomain": "example.om",
    "email": "sales@example.om",
    "emailDomain": "example.om",
    "freeEmailProvider": false,
    "phone": null,
    "address": null,
    "requiredProductOrService": "HVAC maintenance"
  },
  "sources": [],
  "dataCoverage": {
    "registryMatch": false,
    "demoDataOnly": false,
    "liveChecksPerformed": [],
    "unavailableSources": []
  },
  "confidence": 0.1,
  "limitations": [
    "This is an automated public-source procurement screening result and is not a substitute for legal, AML, KYC or regulatory due diligence.",
    "identityConfirmed means the submitted identity is consistent with the registry and contact evidence found; it is not a government verification or certification of the supplier.",
    "Sanctions screening is automated name matching only. A potential_match is not a confirmed listing, and a clear result does not guarantee the supplier is not listed under another name or on a list not checked.",
    "Public-risk signals are unverified public-source indicators, never findings of misconduct. Absence of signals is not a clearance.",
    "procurementSuitability informs the procurement decision; it is not a vendor approval or rejection.",
    "Live website inspection is not enabled for this deployment (RISK_LIVE_CHECKS_ENABLED).",
    "Sanctions lists were not checked: no sanctions source is enabled for this deployment (RISK_LIVE_CHECKS_ENABLED / SUPPLIER_SANCTIONS_PROVIDERS).",
    "Public-web risk screening is not enabled for this deployment (WEB_SEARCH_PROVIDER)."
  ]
}

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "companyName": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    },
    "crNumber": {
      "type": "string",
      "minLength": 3,
      "maxLength": 30,
      "pattern": "^[0-9A-Za-z][0-9A-Za-z\\s\\-/.]*$"
    },
    "website": {
      "type": "string",
      "minLength": 4,
      "maxLength": 300
    },
    "email": {
      "type": "string",
      "maxLength": 254,
      "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
    },
    "phone": {
      "type": "string",
      "minLength": 6,
      "maxLength": 30,
      "pattern": "^[+0-9\\s()\\-.xX*]+$"
    },
    "address": {
      "type": "string",
      "minLength": 2,
      "maxLength": 300
    },
    "requiredProductOrService": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200
    }
  },
  "required": [
    "companyName"
  ],
  "additionalProperties": false
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "supplier": {
      "type": "object",
      "properties": {
        "inputName": {
          "type": "string"
        },
        "normalizedName": {
          "type": "string"
        },
        "matchedName": {
          "type": [
            "string",
            "null"
          ]
        },
        "matchedNameAr": {
          "type": [
            "string",
            "null"
          ]
        },
        "companyId": {
          "type": [
            "string",
            "null"
          ]
        },
        "crNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "crNumberSupplied": {
          "type": [
            "string",
            "null"
          ]
        },
        "country": {
          "type": "string",
          "const": "OM"
        },
        "identityMatch": {
          "type": "string",
          "enum": [
            "strong",
            "moderate",
            "weak",
            "unconfirmed"
          ]
        }
      },
      "required": [
        "inputName",
        "normalizedName",
        "matchedName",
        "matchedNameAr",
        "companyId",
        "crNumber",
        "crNumberSupplied",
        "country",
        "identityMatch"
      ],
      "additionalProperties": false
    },
    "screeningResult": {
      "type": "object",
      "properties": {
        "risk": {
          "type": "string",
          "enum": [
            "low",
            "medium",
            "high",
            "insufficient_data"
          ]
        },
        "riskScore": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "procurementSuitability": {
          "type": "string",
          "enum": [
            "appears_suitable",
            "review_recommended",
            "insufficient_information",
            "potential_risk"
          ]
        },
        "identityConfirmed": {
          "type": "boolean"
        },
        "activityMatch": {
          "type": [
            "boolean",
            "null"
          ]
        },
        "summary": {
          "type": "string"
        }
      },
      "required": [
        "risk",
        "riskScore",
        "procurementSuitability",
        "identityConfirmed",
        "activityMatch",
        "summary"
      ],
      "additionalProperties": false
    },
    "checks": {
      "type": "object",
      "properties": {
        "companyIdentity": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "pass",
                "partial",
                "fail",
                "unknown"
              ]
            },
            "confidence": {
              "type": "number",
              "minimum": 0,
              "maximum": 1
            },
            "explanation": {
              "type": "string"
            },
            "corroborations": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "status",
            "confidence",
            "explanation",
            "corroborations"
          ],
          "additionalProperties": false
        },
        "website": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "pass",
                "partial",
                "fail",
                "unknown"
              ]
            },
            "explanation": {
              "type": "string"
            },
            "url": {
              "type": [
                "string",
                "null"
              ]
            },
            "urlSource": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "supplied",
                    "registry"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "signals": {
              "type": "object",
              "properties": {
                "websiteExists": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "https": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "domainMatchesCompanyName": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "domainMatchesRegistry": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "companyNameOnWebsite": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "corporateEmailOnWebsite": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "phoneOnWebsite": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "physicalAddressOnWebsite": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                },
                "redirectedToDifferentDomain": {
                  "type": [
                    "boolean",
                    "null"
                  ]
                }
              },
              "required": [
                "websiteExists",
                "https",
                "domainMatchesCompanyName",
                "domainMatchesRegistry",
                "companyNameOnWebsite",
                "corporateEmailOnWebsite",
                "phoneOnWebsite",
                "physicalAddressOnWebsite",
                "redirectedToDifferentDomain"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "status",
            "explanation",
            "url",
            "urlSource",
            "signals"
          ],
          "additionalProperties": false
        },
        "businessActivity": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "pass",
                "partial",
                "fail",
                "unknown"
              ]
            },
            "explanation": {
              "type": "string"
            },
            "requiredCategories": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "supplierCategories": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "status",
            "explanation",
            "requiredCategories",
            "supplierCategories"
          ],
          "additionalProperties": false
        },
        "contactConsistency": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "pass",
                "partial",
                "fail",
                "unknown"
              ]
            },
            "explanation": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "explanation"
          ],
          "additionalProperties": false
        },
        "addressConsistency": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "pass",
                "partial",
                "conflict",
                "unknown"
              ]
            },
            "explanation": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "explanation"
          ],
          "additionalProperties": false
        },
        "sanctions": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "clear",
                "potential_match",
                "not_checked",
                "unavailable"
              ]
            },
            "matches": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "matchedAlias": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "source": {
                    "type": "string"
                  },
                  "reference": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "sourceUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "matchScore": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "matchType": {
                    "type": "string",
                    "enum": [
                      "exact_normalized_name",
                      "fuzzy_name"
                    ]
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "matchedAlias",
                  "source",
                  "reference",
                  "sourceUrl",
                  "matchScore",
                  "matchType",
                  "reason"
                ],
                "additionalProperties": false
              }
            },
            "listsChecked": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "listsUnavailable": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "explanation": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "matches",
            "listsChecked",
            "listsUnavailable",
            "explanation"
          ],
          "additionalProperties": false
        },
        "publicRisk": {
          "type": "object",
          "properties": {
            "status": {
              "type": "string",
              "enum": [
                "clear",
                "signal_detected",
                "not_checked",
                "unavailable"
              ]
            },
            "signals": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "public_web_mention",
                      "possible_impersonation",
                      "contradictory_business_identity"
                    ]
                  },
                  "description": {
                    "type": "string"
                  },
                  "evidenceTier": {
                    "type": "string",
                    "enum": [
                      "public_allegation",
                      "automated_indicator"
                    ]
                  },
                  "sourceUrl": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "sourceTitle": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "type",
                  "description",
                  "evidenceTier",
                  "sourceUrl",
                  "sourceTitle"
                ],
                "additionalProperties": false
              }
            },
            "explanation": {
              "type": "string"
            }
          },
          "required": [
            "status",
            "signals",
            "explanation"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "companyIdentity",
        "website",
        "businessActivity",
        "contactConsistency",
        "addressConsistency",
        "sanctions",
        "publicRisk"
      ],
      "additionalProperties": false
    },
    "riskFlags": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "ACTIVITY_MISMATCH",
              "IDENTITY_NOT_CONFIRMED",
              "CR_NUMBER_CONFLICT",
              "COMPANY_NAME_MISMATCH",
              "REGISTRY_IDENTITY_CONFLICT",
              "SUPPLIER_STATUS_NOT_ACTIVE",
              "EMAIL_DOMAIN_MISMATCH",
              "FREE_EMAIL_PROVIDER",
              "WEBSITE_IDENTITY_CONFLICT",
              "WEBSITE_UNREACHABLE",
              "WEBSITE_NO_HTTPS",
              "PHONE_MISMATCH",
              "PHONE_NOT_OMAN",
              "ADDRESS_MISMATCH",
              "ADDRESS_OUTSIDE_OMAN",
              "POTENTIAL_SANCTIONS_MATCH",
              "PUBLIC_RISK_SIGNAL",
              "LOOKALIKE_DOMAIN",
              "DEMO_DATA_ONLY",
              "INSUFFICIENT_PUBLIC_DATA",
              "SOURCE_UNAVAILABLE"
            ]
          },
          "severity": {
            "type": "string",
            "enum": [
              "low",
              "medium",
              "high"
            ]
          },
          "message": {
            "type": "string"
          }
        },
        "required": [
          "code",
          "severity",
          "message"
        ],
        "additionalProperties": false
      }
    },
    "riskModel": {
      "type": "object",
      "properties": {
        "score": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        },
        "thresholds": {
          "type": "object",
          "properties": {
            "medium": {
              "type": "number"
            },
            "high": {
              "type": "number"
            }
          },
          "required": [
            "medium",
            "high"
          ],
          "additionalProperties": false
        },
        "components": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "factor": {
                "type": "string"
              },
              "points": {
                "type": "number"
              },
              "reason": {
                "type": "string"
              }
            },
            "required": [
              "factor",
              "points",
              "reason"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "score",
        "thresholds",
        "components"
      ],
      "additionalProperties": false
    },
    "normalizedInput": {
      "type": "object",
      "properties": {
        "companyName": {
          "type": "string"
        },
        "normalizedName": {
          "type": "string"
        },
        "nameVariants": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "crNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "website": {
          "type": [
            "string",
            "null"
          ]
        },
        "websiteDomain": {
          "type": [
            "string",
            "null"
          ]
        },
        "email": {
          "type": [
            "string",
            "null"
          ]
        },
        "emailDomain": {
          "type": [
            "string",
            "null"
          ]
        },
        "freeEmailProvider": {
          "type": "boolean"
        },
        "phone": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "e164": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "isOman": {
                  "type": "boolean"
                },
                "lineType": {
                  "type": "string",
                  "enum": [
                    "mobile",
                    "landline",
                    "unknown"
                  ]
                }
              },
              "required": [
                "e164",
                "isOman",
                "lineType"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "address": {
          "type": [
            "string",
            "null"
          ]
        },
        "requiredProductOrService": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "companyName",
        "normalizedName",
        "nameVariants",
        "crNumber",
        "website",
        "websiteDomain",
        "email",
        "emailDomain",
        "freeEmailProvider",
        "phone",
        "address",
        "requiredProductOrService"
      ],
      "additionalProperties": false
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "company_registry",
              "company_directory",
              "demo_dataset",
              "company_website",
              "sanctions_list",
              "public_web",
              "derived_consistency_check"
            ]
          },
          "name": {
            "type": "string"
          },
          "url": {
            "type": [
              "string",
              "null"
            ]
          },
          "checkedAt": {
            "type": "string"
          },
          "observedAt": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "type",
          "name",
          "url",
          "checkedAt",
          "observedAt"
        ],
        "additionalProperties": false
      }
    },
    "dataCoverage": {
      "type": "object",
      "properties": {
        "registryMatch": {
          "type": "boolean"
        },
        "demoDataOnly": {
          "type": "boolean"
        },
        "liveChecksPerformed": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "unavailableSources": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "registryMatch",
        "demoDataOnly",
        "liveChecksPerformed",
        "unavailableSources"
      ],
      "additionalProperties": false
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "supplier",
    "screeningResult",
    "checks",
    "riskFlags",
    "riskModel",
    "normalizedInput",
    "sources",
    "dataCoverage",
    "confidence",
    "limitations"
  ],
  "additionalProperties": false
}

Category: Supplier Intelligence · hierarchy: primary · idempotent: yes · side effects: no