payload field of the check result object.
Check ID
kyb.incorporation_document_verification
Response Schema
string
required
Type identifier “KYBIncorporationDocumentVerificationResult”
string
The verified business name extracted from the document
string
The verified incorporation date in YYYY-MM-DD format
object
The verified business address extracted from the document
string
The verified business activity or purpose extracted from the document
string
The jurisdiction where the business is incorporated
string
The verified business registration number
array
List of valid incorporation documents that were successfully verified
array
List of invalid incorporation documents that failed verification
Example Response
Response Fields
string
The type identifier for the response. Will be “KYBIncorporationDocumentVerificationResult”.
array
Array of documents that passed all verification checks.
array
Array of documents that failed one or more verification checks.
string
The confirmed business name after verification checks.
string
The confirmed incorporation date after verification checks.
object
The confirmed business address after verification checks.
string | null
The confirmed business activity type after verification checks.
string
The confirmed legal jurisdiction after verification checks.
string | null
The confirmed business registration number after verification checks.
Alerts
The check result may include alerts that indicate potential issues or concerns with the submitted documents. Alerts are returned as a dictionary where the key is the alert name and the value is a description explaining why the alert was raised.Supported Alerts
string
Raised when a document is marked as invalid in valid_documents. The alert message specifies what fields are required based on the configuration (business name, incorporation date, incorporation address, registration number).
string
Raised when required fields are missing from the document based on the configuration. The alert message lists the specific missing fields.
string
Raised when fraud_verification_data indicates document tampering. The alert message includes the specific type of tampering detected.
string
Raised when there are discrepancies between the provided information and document contents. The alert message specifies which fields have mismatches (e.g. business name, registration number, address) and instructs the user to either update their information or provide matching documents.
Key Components
Document Analysis
Each document invalid_documents or invalid_documents contains the following components:
Extraction Data
boolean
Indicates whether the document structure and content are valid.
string
Detailed analysis of the document content and its validity.
string
Brief overview of the document’s key information.
string
The document’s date in ISO format.
object
Any alerts or warnings associated with the document validation.
string
Primary business name extracted from the document.
array
Array of all business names found in the document.
string
Date of incorporation in ISO format.
object
Primary business address found in the document.
object
Object containing all addresses found in the document.
string | null
Type of business activity mentioned in the document.
string
Legal jurisdiction under which the business is registered.
array
Array of registration numbers found in the document.
Document Metadata
object
Metadata about the document being verified.
string
The type identifier for the document object. Will be “Document”.
string
The URL where the document can be accessed.
string
The name of the document file.
string | null
Optional description of the document.
string
The type of source for the document (e.g., “file_url”).
number | null
The number of pages in the document, if available.
Fraud Verification Data
boolean
Indicates if the document passed all fraud verification checks.
string
Overall risk assessment result (e.g., “HIGH_RISK”, “LOW_RISK”).
array
Array of specific fraud indicators found in the document.
string
Unique identifier for the fraud indicator.
string
Category of the finding (e.g., “RISK”).
string
Specific category of the indicator (e.g., “modifications”).
string
Short description of the finding.
string
Detailed explanation of the fraud indicator.
object | null
Additional data associated with the indicator.
object | null
Additional attributes of the indicator.
string
Source of the fraud detection (e.g., “fraud”).
string
Detailed description of the fraud verification results.
Visual Inspection Results
string
Type identifier for the visual inspection results.
string
Comparative analysis with other reviewed documents.
string
Detailed reasoning behind the visual inspection conclusions.
object
Detailed results of various visual inspection aspects.
object
object
object
boolean
Whether the document passed overall visual inspection.
string
Overview of all visual inspection findings.