Skip to main content

Request Business Verification

Deprecated

This endpoint is deprecated. Use POST /v3/customers/{customer_id}/kyb/request-verification, which verifies the beneficial owners in the same run. It keeps working while integrations move; see Versioning.

This endpoint submits the business banking verification to the provider.

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

Prerequisites​

  • The business information must be submitted using the Submit Business Verification endpoint.
  • Business ownership records must be created using the Submit Business Ownership endpoint.
  • All business owners must have completed their individual KYC verification process.
  • If the account already has an approved banking verification, the existing verification is returned.
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/request-verification

Request Body Sample​

{
  "accountId": "00000000-0000-0000-0000-000000000000"
}

Request Body Schema​

FieldTypeDescription
accountIdstring (uuid)Required. The account ID to verify.

Response Sample​

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "status": "in_review",
  "name": "Acme Corporation",
  "dbaName": "Acme Corp",
  "phone": "+1234567890",
  "address": {
    "address1": "123 Business Ave",
    "address2": "Suite 500",
    "city": "New York",
    "state": "NY",
    "postalCode": "10001",
    "country": "US"
  },
  "idNumber": "123456789",
  "idDocumentType": "ein",
  "taxNumber": "123456789",
  "entityType": "corporation",
  "formationDate": "2021-12-31",
  "incorporationState": "NY",
  "website": "https://acme.example.com",
  "operationAddress": {
    "address1": "456 Operations Blvd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "US"
  },
  "owners": [],
  "verificationFiles": [],
  "eventHistory": [
    {
      "status": "in_review",
      "statusReason": "Verification submitted",
      "date": "2023-01-01T10:00:00Z"
    }
  ],
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-01-01T10:00:00Z"
}

Errors​

StatusMessageMeaning
401unauthorizedMissing or invalid signature.
403forbiddenThe key is account-scoped.
409kyb_owners_missingThe business has no owners. Add them with Submit Business Ownership first.
409kyb_owner_not_approvedAn owner's individual verification is not approved yet. The body does not say which owner: check each owner's status.

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!