> ## 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.
# Individual schema
The Individual Schema contains information about a person. It is used for Know Your Customer (KYC) processes in Parcha's case management system.
## Example
```json Example theme={null}
{
"id": "parcha-kyc-test-2",
"self_attested_data": {
"first_name": "John",
"middle_name": "Michael",
"last_name": "Doe",
"date_of_birth": "YYYY-MM-DD",
"address": {
"street_1": "123 Main Street",
"city": "Anytown",
"state": "ST",
"country_code": "US",
"postal_code": "12345"
},
"associated_addresses": [
{
"street_1": "456 Secondary Street",
"city": "Othertown",
"state": "ST",
"country_code": "US",
"postal_code": "67890"
}
],
"country_of_nationality": "US",
"country_of_residence": "US",
"place_of_birth": "Anytown, State",
"sex": "Male",
"email": "email@example.com",
"phone": "+1234567890",
"title": "Chief Technology Officer",
"is_applicant": false,
"is_business_owner": true,
"business_ownership_percentage": 50
}
}
```
## 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 first name of the individual
The middle name of the individual
The last name of the individual
The date of birth of the individual, format YYYY-MM-DD
The address of the individual
The associated addresses of the individual
The country of nationality of the individual
The country of residence of the individual
The place of birth of the individual
The sex of the individual
The email of the individual
The phone number of the individual
The title of the individual
Whether the individual is an applicant
Whether the individual is a business owner
The percentage of ownership of the individual
The description of the source of funds for the individual
### Document Fields
The following fields are lists of `Document` objects:
* proof\_of\_address\_documents
* source\_of\_funds\_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
* `first_name` and `last_name` are required fields.
* `date_of_birth`, if provided, must be in the format YYYY-MM-DD.
* `email`, if provided, must be a valid email address format.
* `business_ownership_percentage`, if provided, must be a number between 0 and 100.
## Validation Process
When submitting data for the Individual Schema, the system performs several validation checks:
1. Required fields are checked for presence.
2. Field formats are validated (e.g., date formats, email formats).
3. Field values are checked for validity (e.g., ownership percentage range).
4. Associated documents 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:
1. Ensure all required fields are provided.
2. Follow the specified formats for dates, email addresses, and other structured data.
3. Be prepared to handle validation errors and adjust your data accordingly.
Dive into our comprehensive API documentation to understand all available endpoints and features.