Skip to main content

Request Ownership Verification

Deprecated

This endpoint is deprecated, and v3 has no per-owner equivalent. Owners are verified together with the business by POST /v3/customers/{customer_id}/kyb/request-verification, and each must be ready first: details complete, and a selfie and the front of an identity document uploaded through owner documents. It keeps working while integrations move; see Versioning.

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

Takes a workspace-scoped API key. An account-scoped key is refused with 403.

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:

Every request is signed with your API key: a short-lived JWT, signed with your private key, sent in one header on /v3/* and /api/v2/* alike.

Headers:
  Authorization: APIKey {SIGNED_JWT}

How to build and sign the JWT: Authentication.

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/v2/verification/<token>",
  "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!