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.
This schema is crucial for maintaining accurate and comprehensive business records in our system.
Example
Field Descriptions
Case ID
Unique identifier for the case. Used to tie cases together when running workflows and can be used to link back to internal case management systems.
Self Attested Data
The name of the business
The registered name of the business
The address where the business is incorporated
The primary business operation address
The business website(s)
The purpose of the business
A brief description of the business
The industry of the business
Tax Identification Number
Business partners to be screened
Customers to be screened
The business’s funding sources
Countries where customers are located
Date of incorporation (YYYY-MM-DD)
Merchant Category Code
Business contact email
Business contact phone number
Document Fields
The following fields are lists of Document objects:
- incorporation_documents
- business_ownership_documents
- promo_marketing_documents
- proof_of_address_documents
- source_of_funds_documents
- ein_documents
Address Object
Primary street address
Secondary street address
City name
State or province
Postal or ZIP code
Two-letter country code
Document Object
Type of the document
Name of the document file
URL to access the document
Validation Rules
- Either
business_nameorregistered_business_nameis required whenwebsiteis not provided. business_nameandregistered_business_nameare truncated to 64 characters if longer.descriptionis truncated to 512 characters if longer.- If
websiteis provided, it must be a valid URL.
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.
Usage in API
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.