Skip to main content
Business Verification surfaces warnings on the feature item that produced them. Each warning carries the standard structured shape used across the platform — feature, risk, log_type, short_description, long_description, optional additional_data, and node_id — so you can route review work to the right operational team.

​
Overview

KYB sessions emit warnings under three core feature tags that map to dedicated feature arrays in the V3 decision response:
Feature tagDecision response keyWhat it covers
KYB_REGISTRYregistry_checks[].warnings[]Official company-registry lookups. Active status, country restrictions, derivable ownership, missing officer/UBO records.
KYB_DOCUMENTSdocument_verifications[].warnings[]Incorporation, ownership, address, and shareholder documents the user uploads. Cross-document consistency, OCR, metadata, manipulation, age, and subtype rules.
KYB_KEY_PEOPLEkey_people_checks[].warnings[]Person-level signals on directors, officers, UBOs, or user-submitted parties — including PEP/sanctions findings that propagate from AML and prior-decline reuse.
The same KYB workflow can also include the shared features below — they emit warnings on their own arrays:
Feature tagDecision response key
AMLaml_screenings[].warnings[]
PHONEphone_verifications[].warnings[]
EMAILemail_verifications[].warnings[]
QUESTIONNAIREquestionnaire_responses (warnings live on the session log)
LOCATIONip_analyses[].warnings[]

​
KYB Registry warnings

Registry warnings use feature: "KYB_REGISTRY" and appear on registry_checks[].warnings[].
TagDescription
KYB_COUNTRY_RESTRICTEDThe company’s country is outside the allowed countries configured for the workflow.
KYB_OFFICERS_DATA_NOT_FOUNDOfficer data is not available from the registry.
KYB_OWNERSHIP_DATA_NOT_FOUNDOwnership data is not available from the registry.
KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLEUltimate beneficial ownership could not be established from the registry data.
KYB_COMPANY_NOT_ACTIVEThe company is not active according to the registry.
KYB_COMPANY_NOT_FROM_REGISTRYThe company was entered manually and could not be verified against a corporate registry.

​
KYB Document warnings

Document warnings use feature: "KYB_DOCUMENTS" and appear on document_verifications[].warnings[].
TagDescription
KYB_DOCUMENT_MISSING_REQUIRED_FIELDA required company field — such as company name or registration number — was not found in the document.
KYB_DOCUMENT_NAME_MISMATCHThe company name in the document does not match the registry.
KYB_DOCUMENT_REG_NUMBER_MISMATCHThe registration number in the document does not match the registry.
KYB_DOCUMENT_INCORPORATION_DATE_MISMATCHThe incorporation date in the document does not match the registry.
KYB_DOCUMENT_ADDRESS_MISMATCHThe registered address in the document does not match the registry.
KYB_CROSS_DOCUMENT_MISMATCHCompany data differs across uploaded corporate documents.
KYB_DOCUMENT_METADATA_MISMATCHThe document signature, metadata, or file structure indicates a possible issue.
KYB_ASSOCIATED_PARTY_MISMATCHDirectors or shareholders in the document do not match the registry.
KYB_DOCUMENT_GRAPHIC_EDITORThe document appears to have been processed by graphic editing software.
KYB_DOCUMENT_SUSPECTED_MANIPULATIONThe system detected signs of possible corporate-document manipulation.
KYB_ADDITIONAL_DATA_NOT_FOUNDA document field could not be verified because the corresponding registry data is unavailable.
KYB_DOCUMENT_EXPIREDThe corporate document exceeds the configured maximum age.
KYB_DOCUMENT_UNSUPPORTED_SUBTYPEThe uploaded document subtype is disabled for the workflow.
KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDEDThe maximum number of corporate-document upload attempts was exceeded.
For PDF overlay-text manipulation, KYB_DOCUMENT_SUSPECTED_MANIPULATION can include additional_data.manipulated_regions. These are page-coordinate rectangles that identify the suspected edited areas and match the rectangles returned in document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

​
KYB Key People warnings

Key People warnings use feature: "KYB_KEY_PEOPLE" and appear on key_people_checks[].warnings[]. They surface person-level issues on directors, officers, UBOs, and user-submitted parties.
TagDescription
KYB_PREVIOUSLY_DECLINED_INDIVIDUALA person associated with the company was previously declined in another business verification for the same application.
PEP / sanctions hits on key people are reported as standard AML hits on the matching aml_screenings[] item, not as a KYB-key-people warning. The Key People check propagates the resulting Declined or In Review status onto each affected party so the overall key-people verdict reflects the AML outcome.

​
Shared feature warnings

The features below can run inside a KYB workflow. They use the same warning catalog as User Verification — full reference on each feature’s own warnings page.

​
AML

feature: "AML" on aml_screenings[].warnings[].
TagDescription
POSSIBLE_MATCH_FOUNDThe AML screening found a possible match requiring review.
COULD_NOT_PERFORM_AML_SCREENINGDidit could not perform the AML screening because required screening data was missing or unavailable.

​
Phone

feature: "PHONE" on phone_verifications[].warnings[].
TagDescription
DISPOSABLE_NUMBER_DETECTEDThe phone number is disposable.
VERIFICATION_CODE_ATTEMPTS_EXCEEDEDThe maximum number of verification-code attempts was exceeded.
VOIP_NUMBER_DETECTEDThe phone number is a VoIP number.
DUPLICATED_PHONE_NUMBERThe phone number was used in another verification process.
HIGH_RISK_PHONE_NUMBERThe phone number is high risk.
PHONE_NUMBER_IN_BLOCKLISTThe phone number matches an entry in your blocklist.

​
Email

feature: "EMAIL" on email_verifications[].warnings[].
TagDescription
BREACHED_EMAIL_DETECTEDThe email address appears in known data breaches.
DISPOSABLE_EMAIL_DETECTEDThe email address is disposable.
UNDELIVERABLE_EMAIL_DETECTEDThe email address is undeliverable.
DUPLICATED_EMAILThe email address was used in another verification process.
EMAIL_IN_BLOCKLISTThe email address matches an entry in your blocklist.
EMAIL_CODE_ATTEMPTS_EXCEEDEDThe maximum number of email verification-code attempts was exceeded.

​
Questionnaire

feature: "QUESTIONNAIRE".
TagDescription
CUSTOM_STATUS_RULE_TRIGGEREDA workflow status rule evaluated a questionnaire answer and changed the feature status.

​
Device & IP Analysis

feature: "LOCATION" on ip_analyses[].warnings[].
TagDescription
COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IPThe document country does not match the IP country.
PRIVATE_NETWORK_DETECTEDA private network, VPN, proxy, or Tor signal was detected.
EXPECTED_IP_ADDRESS_MISMATCHThe IP address does not match the expected IP address provided for the session.
IP_ADDRESS_IN_BLOCKLISTThe IP address matches an entry in your blocklist.
DEVICE_FINGERPRINT_IN_BLOCKLISTThe device fingerprint matches an entry in your blocklist.
DUPLICATED_IP_ADDRESSThe same IP address was used in another verification with different vendor_data.
DUPLICATED_DEVICE_FINGERPRINTThe same device fingerprint was used in another verification with different vendor_data.

​
Examples

​
Registry — company not active

{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}

​
Documents — suspected overlay manipulation

{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}

​
Key people — previously declined individual

{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}

Response schema

See where warnings appear in each KYB feature array.

Statuses

Understand how warning severity maps to verification status.

Documents

Review document groups, OCR, and cross-check behavior.

Key people

Officer, UBO, and submitted-party verification flow.

AML report

Hit-level structure for company and person AML screenings.

Reference data models

Canonical shapes for warnings and feature arrays.