Incorporation Document Verification Result
Response schema for incorporation document verification checks
The Incorporation Document Verification check returns a detailed analysis of the provided incorporation documents and verification results. The check result will be returned in the payload
field of the check result object.
Response Schema
Type identifier “KYBIncorporationDocumentVerificationResult”
The verified business name extracted from the document
The verified incorporation date in YYYY-MM-DD format
The verified business address extracted from the document
The verified business activity or purpose extracted from the document
The jurisdiction where the business is incorporated
The verified business registration number
List of valid incorporation documents that were successfully verified
List of invalid incorporation documents that failed verification
Example Response
Response Fields
The type identifier for the response. Will be “KYBIncorporationDocumentVerificationResult”.
Array of documents that passed all verification checks.
Array of documents that failed one or more verification checks.
The confirmed business name after verification checks.
The confirmed incorporation date after verification checks.
The confirmed business address after verification checks.
The confirmed business activity type after verification checks.
The confirmed legal jurisdiction after verification checks.
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
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).
Raised when required fields are missing from the document based on the configuration. The alert message lists the specific missing fields.
Raised when fraud_verification_data indicates document tampering. The alert message includes the specific type of tampering detected.
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 in valid_documents
or invalid_documents
contains the following components:
Extraction Data
Indicates whether the document structure and content are valid.
Detailed analysis of the document content and its validity.
Brief overview of the document’s key information.
The document’s date in ISO format.
Any alerts or warnings associated with the document validation.
Primary business name extracted from the document.
Array of all business names found in the document.
Date of incorporation in ISO format.
Primary business address found in the document.
Object containing all addresses found in the document.
Type of business activity mentioned in the document.
Legal jurisdiction under which the business is registered.
Array of registration numbers found in the document.
Document Metadata
Metadata about the document being verified.
The type identifier for the document object. Will be “Document”.
The URL where the document can be accessed.
The name of the document file.
Optional description of the document.
The type of source for the document (e.g., “file_url”).
The number of pages in the document, if available.
Fraud Verification Data
Indicates if the document passed all fraud verification checks.
Overall risk assessment result (e.g., “HIGH_RISK”, “LOW_RISK”).
Array of specific fraud indicators found in the document.
Unique identifier for the fraud indicator.
Category of the finding (e.g., “RISK”).
Specific category of the indicator (e.g., “modifications”).
Short description of the finding.
Detailed explanation of the fraud indicator.
Additional data associated with the indicator.
Additional attributes of the indicator.
Source of the fraud detection (e.g., “fraud”).
Detailed description of the fraud verification results.
Visual Inspection Results
Type identifier for the visual inspection results.
Comparative analysis with other reviewed documents.
Detailed reasoning behind the visual inspection conclusions.
Detailed results of various visual inspection aspects.
Whether the document passed overall visual inspection.
Overview of all visual inspection findings.