Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Business Verification warnings are returned in the warnings array for the feature that produced them. This lets you route review work to the right operational team: registry issues, document issues, AML issues, key-people issues, contact checks, questionnaire rules, or IP analysis. Each warning includes the same structured fields used by User Verification warnings: feature, risk, log_type, short_description, long_description, and optional additional_data.

Registry check warnings

Registry check warnings use feature: "KYB_REGISTRY".
TagDescription
KYB_COUNTRY_RESTRICTEDThe company’s country is outside the allowed countries configured for the workflow.
KYB_OFFICERS_DATA_NOT_FOUNDCompany officers 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 submitted manually and could not be verified against a corporate registry.

KYB document warnings

KYB document warnings use feature: "KYB_DOCUMENTS".
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.

AML warnings

AML warnings use feature: "AML" in Business Verification sessions.
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.

Key people warnings

Key people warnings use feature: "KYB_KEY_PEOPLE".
TagDescription
KYB_PREVIOUSLY_DECLINED_INDIVIDUALA person associated with the company was previously declined in another business verification for the same application.

Phone warnings

Phone warnings use feature: "PHONE" when the Business Verification workflow includes phone verification.
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 warnings

Email warnings use feature: "EMAIL" when the Business Verification workflow includes email verification.
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 warnings

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

IP analysis warnings

IP analysis warnings use feature: "LOCATION" when the Business Verification workflow includes IP analysis.
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.

Next steps

Response schema

See where warnings appear in each KYB feature array.

Statuses

Understand how warning severity maps to verification status.

Documents

Review document groups and cross-check behavior.