Submit Business Verification

This endpoint initiates the banking verification process for business accounts. It saves the business information but does not submit to the verification provider.

Use the Request Business Verification endpoint to submit the verification to the provider.

The account must be in pending or needs_update status to submit verification data.

Authorization:

bearer

HTTP: bearer

HTTP Authorization Scheme: bearer

Headers:
  Authorization: APIKey {YOUR_API_KEY}

Endpoint

POST

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

Request Body Sample

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "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.com",
  "operationAddress": {
    "address1": "456 Operations Blvd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "US"
  }
}

Request Body Schema

Field	Type	Description
accountId	string (uuid)	Required. The account ID to verify.
name	string	Required. Business name. Min 2, max 255 characters.
dbaName	string	Required. Doing business as name. Min 2, max 255 characters.
phone	string	Required. Phone number in E.164 format.
address	object	Required. Business address.
idNumber	string	Required. Business ID number (EIN).
idDocumentType	string	Required. ID document type (e.g., ein).
taxNumber	string	Required. Tax number.
entityType	string	Required. Entity type (e.g., corporation, llc, partnership, sole_proprietorship).
formationDate	string	Required. Formation date in YYYY-MM-DD format.
incorporationState	string	Required. State of incorporation.
website	string	Required. Business website URL.
operationAddress	object	Required. Operation address. Same schema as address.

Response Sample

{
  "accountId": "00000000-0000-0000-0000-000000000000",
  "status": "pending",
  "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.com",
  "operationAddress": {
    "address1": "456 Operations Blvd",
    "city": "New York",
    "state": "NY",
    "postalCode": "10002",
    "country": "US"
  },
  "owners": [],
  "verificationFiles": [],
  "eventHistory": [],
  "createdAt": "2023-01-01T00:00:00Z",
  "updatedAt": "2023-01-01T00:00:00Z"
}

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!