Submit Business Ownership

This endpoint saves ownership data for a business account. It does not submit to the verification provider or change the status.

Use the Request Ownership Verification endpoint to submit the ownership verification to the provider and generate a verification link.

Authorization:

bearer

HTTP: bearer

HTTP Authorization Scheme: bearer

Headers:
  Authorization: APIKey {YOUR_API_KEY}

Endpoint

POST

/api/v2/kyb/banking-verification/business/ownership

Request Body Sample

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "ownerId": "00000000-0000-0000-0000-000000000001",
  "firstName": "John",
  "lastName": "Wick",
  "email": "jwick@blockwyre.com",
  "phone": "+1234567890",
  "dateOfBirth": "1990-05-15",
  "documentId": {
    "idNumber": "123456789",
    "idDocumentType": "passport",
    "idIssueDate": "2020-01-01",
    "idExpiryDate": "2030-01-01",
    "idCountryOfIssue": "US",
    "nationality": "US"
  },
  "address": {
    "address1": "123 Main St",
    "address2": "Apt 4B",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "ownershipPercentage": 100,
  "role": "owner"
}

Request Body Schema

Field	Type	Description
accountId	string (uuid)	Required. The account ID.
ownerId	string (uuid)	Required. The owner ID.
firstName	string	Required. Owner's first name. Min 2, max 255 characters.
lastName	string	Required. Owner's last name. Min 2, max 255 characters.
email	string	Required. Owner's email address.
phone	string	Required. Phone number in E.164 format.
dateOfBirth	string	Required. Date of birth in YYYY-MM-DD format.
documentId	object	Required. Document identification information.
address	object	Required. Owner's address.
ownershipPercentage	number	Required. Ownership percentage (1-100).
role	string	Required. Role in the business. Min 2, max 255 characters.

Response Sample

{
  "ownerId": "00000000-0000-0000-0000-000000000001",
  "status": "pending",
  "firstName": "John",
  "lastName": "Wick",
  "email": "jwick@blockwyre.com",
  "phone": "+1234567890",
  "dateOfBirth": "1990-05-15",
  "documentId": {
    "idNumber": "123456789",
    "idDocumentType": "passport",
    "idIssueDate": "2020-01-01",
    "idExpiryDate": "2030-01-01",
    "idCountryOfIssue": "US",
    "nationality": "US"
  },
  "address": {
    "address1": "123 Main St",
    "address2": "Apt 4B",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "ownershipPercentage": 100,
  "role": "owner"
}

Support and Resources

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

• Instagram: BlockWyre Instagram
• Twitter: BlockWyre Twitter
• Facebook: BlockWyre Facebook
• LinkedIn: BlockWyre LinkedIn

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!