The Associated Entity Schema contains information about entities associated with the main business or individual. It is used for tracking Ultimate Beneficial Owners (UBOs) and other related entities in Parcha’s case management system.

This schema is crucial for maintaining accurate records of related entities and ensuring compliance with KYB regulations.

​
Example

​
Field Descriptions

​
Case ID

id
string
required

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

self_attested_data.business_name
string

The name of the UBO entity

self_attested_data.registered_business_name
string

The registered name of the business

self_attested_data.incorporation_date
string

The incorporation date of the UBO entity, format YYYY-MM-DD

self_attested_data.is_trust
boolean

Whether or not the UBO Entity is a trust

self_attested_data.address
Address

The address of the business

self_attested_data.industry
string

The industry of the UBO entity

self_attested_data.tin_number
string

The tax identification number of the business

self_attested_data.is_business_owner
boolean

Whether or not the UBO entity is a business owner

self_attested_data.business_ownership_percentage
number

The business ownership percentage of the business

self_attested_data.website
string | string[]

The website(s) of the business

self_attested_data.description
string

The description of the business

self_attested_data.relationship
string

The relationship of the business to the main entity

self_attested_data.skip_validation
boolean

Whether or not to skip KYB validation, for cases when it is a well-known company

​
Address Object

street_1
string
required

Primary street address

street_2
string

Secondary street address

city
string
required

City name

state
string

State or province

postal_code
string
required

Postal or ZIP code

country_code
string
required

Two-letter country code

​
Validation Rules

  • incorporation_date, if provided, must be in the format YYYY-MM-DD.
  • business_ownership_percentage, if provided, must be a number between 0 and 100.
  • If website is provided, it must be a valid URL or a list of valid URLs.
  • description is typically limited to a maximum length (e.g., 512 characters).

​
Validation Process

When submitting data for the Associated Entity Schema, the system performs several validation checks:

  1. Field formats are validated (e.g., date formats, URL formats).
  2. Field values are checked for validity (e.g., ownership percentage range).
  3. If skip_validation is false, additional KYB (Know Your Business) checks may be performed.

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:

  1. Provide as much information as available about the associated entity.
  2. Follow the specified formats for dates, URLs, and other structured data.
  3. Set skip_validation to true only for well-known entities where extensive KYB checks are not necessary.
  4. 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.

Individual schemaExtra fields