Incorporation Document Verification Response

The incorporation document verification check response payload contains a detailed analysis of submitted business incorporation documents. The response includes extracted information, fraud detection findings, visual inspection, and overall validation results.

Response Structure

{
  type: "KYBIncorporationDocumentVerificationResult";
  valid_documents: Array<Document>;
  invalid_documents: Array<Document>;
  verified_business_name: string;
  verified_incorporation_date: string;
  verified_business_address: Address;
  verified_business_activity: string | null;
  verified_jurisdiction: string;
  verified_registration_number: string | null;
}

Response Fields

type
string

The type identifier for the response. Will be “KYBIncorporationDocumentVerificationResult”.

valid_documents
array

Array of documents that passed all verification checks.

invalid_documents
array

Array of documents that failed one or more verification checks.

verified_business_name
string

The confirmed business name after verification checks.

verified_incorporation_date
string

The confirmed incorporation date after verification checks.

verified_business_address
object

The confirmed business address after verification checks.

verified_business_activity
string | null

The confirmed business activity type after verification checks.

verified_jurisdiction
string

The confirmed legal jurisdiction after verification checks.

verified_registration_number
string | null

The confirmed business registration number after verification checks.

Key Components

Document Analysis

Each document in valid_documents or invalid_documents contains the following components:

Extraction Data

is_valid_document
boolean

Indicates whether the document structure and content are valid.

analysis
string

Detailed analysis of the document content and its validity.

summary
string

Brief overview of the document’s key information.

date
string

The document’s date in ISO format.

alerts
object

Any alerts or warnings associated with the document validation.

business_name
string

Primary business name extracted from the document.

all_business_names
array

Array of all business names found in the document.

incorporation_date
string

Date of incorporation in ISO format.

business_address
object

Primary business address found in the document.

all_extracted_addresses
object

Object containing all addresses found in the document.

business_activity
string | null

Type of business activity mentioned in the document.

jurisdiction
string

Legal jurisdiction under which the business is registered.

business_registration_number
array

Array of registration numbers found in the document.

Fraud Verification Data

verification_passed
boolean

Indicates if the document passed all fraud verification checks.

verification_result
string

Overall risk assessment result (e.g., “HIGH_RISK”, “LOW_RISK”).

verification_data
array

Array of specific fraud indicators found in the document.

indicator_id
string

Unique identifier for the fraud indicator.

type
string

Category of the finding (e.g., “RISK”).

category
string

Specific category of the indicator (e.g., “modifications”).

title
string

Short description of the finding.

description
string

Detailed explanation of the fraud indicator.

metadata
object | null

Additional data associated with the indicator.

indicator_attributes
object | null

Additional attributes of the indicator.

origin
string

Source of the fraud detection (e.g., “fraud”).

verification_description
string

Detailed description of the fraud verification results.

Visual Inspection Results

type
string

Type identifier for the visual inspection results.

comparison
string

Comparative analysis with other reviewed documents.

reasoning
string

Detailed reasoning behind the visual inspection conclusions.

visual_analysis
object

Detailed results of various visual inspection aspects.

document_analysis_and_classification
object
analysis
string

Analysis of document type and classification.

passed
boolean

Whether the document passed classification checks.

seal_verification
object
analysis
string

Analysis of document seals and stamps.

passed
boolean

Whether the seal verification passed.

present
boolean

Whether a seal is present on the document.

signature_verification
object
analysis
string

Analysis of document signatures.

passed
boolean

Whether the signature verification passed.

present
boolean

Whether signatures are present on the document.

document_layout_and_content_verification
object
analysis
string

Analysis of document layout and content structure.

passed
boolean

Whether the layout verification passed.

inspection_passed
boolean

Whether the document passed overall visual inspection.

summary
string

Overview of all visual inspection findings.

Address Object Structure

{
  type: "Address";
  street_1: string;
  street_2: string | null;
  city: string;
  state: string;
  country_code: string;
  postal_code: string;
}

Example Response

{
  "type": "KYBIncorporationDocumentVerificationResult",
  "valid_documents": [],
  "invalid_documents": [{
    "extraction_data": {
      "is_valid_document": true,
      "business_name": "Acme, Inc",
      "incorporation_date": "2023-03-05",
      // ... additional fields
    },
    "fraud_verification_data": {
      "verification_passed": false,
      "verification_result": "HIGH_RISK",
      // ... additional fields
    },
    "visual_inspection": {
      "inspection_passed": false,
      // ... additional fields
    }
  }],
  "verified_business_name": "Acme, Inc",
  "verified_incorporation_date": "2023-03-05",
  // ... additional fields
}