Skip to main content

Request Ownership Verification

This endpoint submits the ownership verification to the provider and generates a verification link.

Prerequisites​

  • The ownership data must be submitted first using the Submit Business Ownership endpoint.
  • If the owner is already approved or in_review, the existing verification is returned.

Technical Details​

  • Status Change: Submitting verification changes the owner status from pending to in_review.
  • A verification URL is generated for the owner to complete the verification process.
Authorization:

bearer

HTTP: bearer

HTTP Authorization Scheme: bearer

Headers:
  Authorization: APIKey {YOUR_API_KEY}

Endpoint

POST

/api/v2/kyb/banking-verification/business/ownership/{ownerId}/request-verification

Path Parameters​

ParameterTypeDescription
ownerIdstring (uuid)Required. The owner ID to request verification for.

Response Sample​

{
  "ownerId": "00000000-0000-0000-0000-000000000001",
  "status": "in_review",
  "verificationUrl": "https://verify.blockwyre.com/v/abc123def456",
  "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:

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!