{
"agent_key": "<string>",
"check_ids": [
"<string>"
]
}Know Your Business (KYB)
Business Schema
The Business Schema contains information about a business entity. It is used for Know Your Business (KYB) processes in Parcha’s case management system.
The Business Schema contains information about a business entity. It is used for Know Your Business (KYB) processes in Parcha’s case management system.
This schema is crucial for maintaining accurate and comprehensive business records in our system.
How to Prepare Your Schema
Follow these steps to prepare your business schema based on the checks you want to run:Step 1: Identify Required Schema Fields for Checks
First, determine which checks you need to run. Common check types include. The following sections detail which attributes are required (✓) for each check:Show Basic Business Profile Check
Show Basic Business Profile Check
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
websiteoraddress_of_operation(city, state, country) oraddress_of_incorporation(city, state, country)
- ✓
description - ✓
industry - ✓
address_of_operation - ✓
address_of_incorporation
Show Adverse Media Screening
Show Adverse Media Screening
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
address_of_incorporationand/oraddress_of_operation
Show Web Presence Check
Show Web Presence Check
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
website
- ✓
description - ✓
industry
Show High Risk Country Check
Show High Risk Country Check
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
websiteand/oraddress_of_incorporationand/oraddress_of_operation
Show Business Reviews Check
Show Business Reviews Check
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
address_of_operationand/oraddress_of_incorporation
Show High Risk Industry Check
Show High Risk Industry Check
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
websiteand/oraddress_of_operationand/oraddress_of_incorporation
- ✓
business_purpose - ✓
industry
Show Business Ownership Document Verification
Show Business Ownership Document Verification
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
business_ownership_documents - ✓
associated_entities
Show Incorporation Document Verification
Show Incorporation Document Verification
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
incorporation_documents
- ✓
incorporation_date - ✓
business_registration_number - ✓
address_of_incorporation
Show Proof of Address Document Verification
Show Proof of Address Document Verification
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
proof_of_address_documents - ✓
address_of_operation
Show EIN Document Verification
Show EIN Document Verification
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
tin_number - ✓
ein_documents
Show Source of Funds Document Verification
Show Source of Funds Document Verification
Required attributes:
- ✓
business_nameand/orregistered_business_name - ✓
source_of_funds_documents - ✓
external_validation_data.source_of_funds
While some attributes are marked as optional, providing them can improve the accuracy and comprehensiveness of the check results.
Step 2: Gather Required Information
For each required field:-
Basic Information
- Business name (max 64 characters)
- Website URL (if available)
- Business description (max 512 characters)
- Industry classification
- Tax ID number (if required)
-
Address Information
- Operating address
- Incorporation address (if different)
- Include all required address fields (street, city, state, postal code, country)
-
Documents
- Prepare URLs for required documents
- Ensure documents are accessible
- Use proper file names and source types
-
Associated Data
- List of partners and customers
- Source of funds information
- Associated individuals and entities
Step 3: Validate Your Data
Before submitting:-
Check Field Requirements
- Verify all required fields are present
- Ensure field lengths are within limits
- Validate URL formats
- Check date formats (YYYY-MM-DD)
-
Document Accessibility
- Test all document URLs
- Verify document permissions
- Check file formats
-
Data Completeness
- Review the Check Requirements table
- Ensure all required fields for your checks are included
- Consider adding optional fields for better results
Validation Rules
business_nameis required and is truncated to 64 characters if longerdescriptionis truncated to 512 characters if longer- If
websiteis provided, it must be a valid URL incorporation_datemust be in YYYY-MM-DD format if provided
Validation Process
When submitting data for the Business Schema, the system performs several validation checks:- Required fields are checked for presence
- Field formats are validated (e.g., date formats, URL formats)
- Field lengths are checked and truncated if necessary
- Associated individuals and entities are processed and validated
If any validation errors occur, the system will return a
SchemaValidationError with details about the specific fields that failed validation.Step 4: Structure Your Schema
Follow this template structure:{
"id": "your-case-id",
"self_attested_data": {
// Required fields based on your checks
"business_name": "Your Business Name",
"website": "https://your-website.com",
// ... other fields
}
}
While some fields are optional, providing them can improve the accuracy and comprehensiveness of the check results.
- All URLs must be accessible
- Document URLs must be direct download links
- Dates must be in YYYY-MM-DD format
- Country codes must be ISO 3166-1 alpha-2 format
Step 5: Use the Schema in API Calls
When using this schema in API calls:- Ensure all required fields are provided
- Follow the specified formats for dates, URLs, and other structured data
- Be prepared to handle validation errors and adjust your data accordingly
API Documentation
Dive into our comprehensive API documentation to understand all available endpoints and features.