This endpoint starts a KYB (Know Your Business) agent job with the specified parameters.
API Endpoint POST https://api.parcha.ai/api/v1/startKYBAgentJob Request Body The unique identifier for the agent to be used for the KYB job.
The KYB schema containing the business information. Show KYB Schema Properties
A unique identifier for this KYB case.
Self-attested information about the business. Standard address format used throughout the schema. Primary street address line
Secondary street address line (optional)
Two-letter ISO country code (e.g., “US”, “GB”)
Standard document format used throughout the schema. URL to access the document. Required if b64_document is not provided.
Name of the file including extension
Type of document source. Currently supported: “file_url”
Base64 encoded document content. Required if url is not provided.
Show Self Attested Data Properties
The name of the business. Required if website is not provided.
The registered name of the business. Required if website is not provided and business_name is not set.
The business’s operational address.
Uses the Address Object format defined above.
The business’s incorporation address.
Uses the Address Object format defined above.
The website of the business. Required if business_name or registered_business_name is not provided.
The primary purpose or activity of the business.
A brief description of the business. Maximum 512 characters.
The industry sector the business operates in.
Tax Identification Number or Employer Identification Number (EIN).
Date of incorporation in YYYY-MM-DD format.
Array of business partner names.
Array of funding sources (e.g., [“Investment”, “Revenue”]).
Array of incorporation document objects.
Each item uses the Document Object format defined above.
business_ownership_documents
Array of ownership document objects.
Each item uses the Document Object format defined above.
promo_marketing_documents
Array of promotional/marketing document objects.
Each item uses the Document Object format defined above.
proof_of_address_documents
Array of address proof document objects.
Each item uses the Document Object format defined above.
Array of EIN document objects.
Each item uses the Document Object format defined above.
source_of_funds_documents
Array of funding source document objects.
Each item uses the Document Object format defined above.
Array of individuals associated with the business. Show Associated Individual Properties
Unique identifier for the individual.
Show Individual Data Properties
Date of birth in YYYY-MM-DD format
Individual’s address.
Uses the Address Object format defined above.
Two-letter ISO country code of nationality
Two-letter ISO country code of residence
Place of birth (city, country)
Whether this individual is the applicant
Whether this individual is a business owner
business_ownership_percentage
Percentage of business ownership
proof_of_address_documents
Array of address proof document objects.
Each item uses the Document Object format defined above.
Array of entities associated with the business. Show Associated Entity Properties
Unique identifier for the entity
Show Entity Data Properties
Name of the associated business
Whether the entity is a trust
Entity’s address.
Uses the Address Object format defined above.
Tax Identification Number
business_ownership_percentage
Percentage of business ownership
Two-letter ISO country code
Description of the entity
Optional. A unique identifier (UUID) that you can provide for this job.
If provided, this ID will be used as an idempotency key.
If a job with this ID already exists, the API will return a 409 Conflict error, and you can then use this job_id to retrieve the existing job’s status and results using /getJobById.
If not provided, a new unique ID will be automatically generated for the job.
An optional URL to receive webhook notifications about the job status.
An optional Slack webhook URL to receive notifications about the job status.
An optional array of specific check IDs to run. If not provided, all checks will be run.
Response The status of the job creation request. Will be “ok” if successful.
The unique identifier for the created job.
A message indicating the result of the job creation request.
Details about the created job. The unique identifier of the job.
The current status of the job (e.g., “PENDING”, “RUNNING”, “COMPLETE”, “FAILED”, “RETRIED”).
The timestamp when the job was created.
The timestamp when the job was last updated.
The ID of the agent used for this job.
The input payload provided for the job.
Example Request curl -X POST 'https://api.parcha.ai/startKYBAgentJob' \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "agent_key": "public-bdd", "job_id": "your-custom-job-id-123e4567-e89b-12d3-a456-426614174001", "kyb_schema": { "id": "parcha-demo-case-001", "self_attested_data": { "business_name": "Acme Corp", "website": "https://www.acmecorp.com" } } }'
Example Response Successful creation (200 OK):
{ "status" : "ok" , "job_id" : "job-12345-abcde" , "message" : "The job was successfully added to the queue." , "job" : { "id" : "job-12345-abcde" , "status" : "PENDING" , "created_at" : "2023-06-15T10:30:00Z" , "updated_at" : "2023-06-15T10:30:00Z" , "agent_id" : "public-bdd" , "input_payload" : { "agent_key" : "public-bdd" , "kyb_schema" : { "id" : "parcha-demo-case-001" , "self_attested_data" : { "business_name" : "Acme Corp" , "website" : "https://www.acmecorp.com" } } } } } Conflict (409 Conflict) if job_id already exists:
{ "error" : "Job with the provided ID already exists." , "job_id" : "your-custom-job-id-123e4567-e89b-12d3-a456-426614174001" } This endpoint initiates a KYB agent job with the provided parameters. The response includes a job ID that can be used to track the progress and retrieve results of the KYB process. 
