Documentation Index
Fetch the complete documentation index at: https://docs.parcha.ai/llms.txt
Use this file to discover all available pages before exploring further.
The Business Ownership Document Verification check helps verify the authenticity of business ownership documents and validates the ownership structure of a business. This guide explains how to run the check, what data to provide, and how to interpret the results.
Check ID
kyb.business_ownership_verification_tool
Overview
The check analyzes various aspects of business ownership documents:
- Document authenticity and validity
- Business owner verification
- Ownership share validation
- Document type verification
- Total ownership verification
How the Check Works
-
Document Analysis
- Extracts key information from business ownership documents
- Validates document structure and format
- Verifies document authenticity
- Identifies business owners and their ownership shares
-
Information Verification
- Cross-references extracted data with self-attested information
- Validates business owner names match
- Confirms ownership shares
- Verifies total ownership percentage
-
Ownership Validation
- Verifies all significant owners (≥25%) are disclosed
- Validates ownership shares add up to expected total
- Checks for missing or undocumented owners
- Ensures ownership information is complete and accurate
Document Requirements
The following information must be present in the business ownership documents for it to be considered valid:
Cap Table or Share Register
- Names of all shareholders/owners
- Number of shares or ownership percentage for each owner
- Total number of shares or ownership percentages must sum to 100%
- Date of ownership information
Operating Agreement
- Names of all members/owners
- Ownership percentages or shares for each member
- Roles and responsibilities of members
- Date of agreement
Share Certificates
- Name of shareholder
- Number of shares owned
- Class of shares
- Date of issuance
- Company name and registration details
Partnership Agreement
- Names of all partners
- Partnership type (general, limited, etc.)
- Ownership percentages or profit-sharing ratios
- Date of agreement
Articles of Organization (if sole proprietorship)
- Name of sole owner
- Business name
- Date of organization
- Confirmation of 100% ownership
Check Configuration
The check can be configured with the following parameters:
Minimum percentage of ownership to be considered significant. Owners with ownership percentage at or above this threshold must be included in self-attested data.
total_ownership_threshold
Total percentage of ownership that must be accounted for in the documentation. The check will fail if the total documented ownership is less than this threshold.
check_self_attested_ownership
Whether to verify that self-attested ownership shares match the documented shares. If true, the check will fail if self-attested ownership data is missing.
enable_visual_verification
Whether to enable visual verification of documents.
Whether to enable document fraud detection.
include_incorporation_documents
Whether to include incorporation documents in the ownership verification process.
Example Configuration
{
"min_ownership_threshold": 25,
"total_ownership_threshold": 100,
"check_self_attested_ownership": true,
"enable_visual_verification": true,
"enable_fraud_check": true,
"include_incorporation_documents": false
}
Running the Check
API Endpoint
POST https://api.parcha.ai/api/v1/startKYBAgentJob
Example Request
curl -X POST 'https://api.parcha.ai/api/v1/startKYBAgentJob' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"agent_key": "your-kyb-agent-key",
"check_id": "kyb.business_ownership_verification_tool",
"kyb_schema": {
"id": "ownership-check-001",
"self_attested_data": {
"business_name": "Acme Corp, Inc.",
"business_ownership_documents": [
{
"url": "https://storage.googleapis.com/parcha-ai-public-assets/acme_cap_table.pdf",
"file_name": "acme_cap_table.pdf",
"source_type": "file_url"
}
]
},
"associated_individuals": [
{
"id": "owner-001",
"self_attested_data": {
"first_name": "John",
"last_name": "Smith",
"title": "CEO",
"is_business_owner": true,
"business_ownership_percentage": 60
}
},
{
"id": "owner-002",
"self_attested_data": {
"first_name": "Jane",
"last_name": "Doe",
"title": "CTO",
"is_business_owner": true,
"business_ownership_percentage": 30
}
}
],
"associated_entities": [
{
"id": "entity-001",
"self_attested_data": {
"business_name": "Venture Capital LLC",
"business_ownership_percentage": 10,
"is_trust": false
}
}
]
},
"check_args": {
"min_ownership_threshold": 25,
"total_ownership_threshold": 100,
"check_self_attested_ownership": true,
"enable_visual_verification": true,
"enable_fraud_check": true,
"include_incorporation_documents": false
},
"webhook_url": "https://your-webhook.com/check-updates"
}'
Initial Response
{
"id": "job-abc123",
"status": "PENDING",
"created_at": "2024-02-15T10:30:00Z",
"updated_at": "2024-02-15T10:30:00Z",
"agent_id": "your-agent-key",
"input_payload": {
// Original request payload
}
}
Retrieving Check Results
Once the job is complete, retrieve the results using the job ID with the getJobByID endpoint. Make sure to include the include_check_results=true parameter to get the full check results.
GET https://api.parcha.ai/api/v1/getJobByID?job_id=job-abc123&include_check_results=true
Example Response
{
"id": "check-12345-abcde",
"status": "PENDING",
"created_at": "2024-03-15T15:30:00Z",
"updated_at": "2024-03-15T15:30:00Z",
"agent_id": "your-agent-key",
"input_payload": {
"agent_key": "your-kyb-agent-key",
"check_id": "kyb.business_ownership_verification_tool",
"payload": {
"id": "ownership-check-001",
"self_attested_data": {
"business_name": "Acme Corp, Inc.",
"business_ownership_documents": [
{
"url": "https://storage.googleapis.com/parcha-ai-public-assets/acme_cap_table.pdf",
"file_name": "acme_cap_table.pdf",
"source_type": "file_url"
}
]
},
"associated_individuals": [
{
"id": "owner-001",
"self_attested_data": {
"first_name": "John",
"last_name": "Smith",
"title": "CEO",
"is_business_owner": true,
"business_ownership_percentage": 60
}
},
{
"id": "owner-002",
"self_attested_data": {
"first_name": "Jane",
"last_name": "Doe",
"title": "CTO",
"is_business_owner": true,
"business_ownership_percentage": 30
}
}
],
"associated_entities": [
{
"id": "entity-001",
"self_attested_data": {
"business_name": "Venture Capital LLC",
"business_ownership_percentage": 10,
"is_trust": false
}
}
]
},
"check_args": {
"min_ownership_threshold": 25,
"total_ownership_threshold": 100,
"check_self_attested_ownership": true,
"enable_visual_verification": true,
"enable_fraud_check": true,
"include_incorporation_documents": false
},
"webhook_url": "https://your-webhook.com/check-updates"
}
}
Check Results
The check returns a detailed analysis of the business ownership documents and verification results. For full details of the response structure, see the Business Ownership Document Verification Result documentation.
