Sample - Plaid API
POST/business_verification/create

Create a business verification

Creates a new business verification to assess a business's identity and risk profile. Supply client_user_id and provide the business details you want to use for the verification, including a valid website, phone number, or email address when applicable. The response contains the created verification and its assessment results.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 body fields

Request data for creating a business verification, including the end user's identifier and optional business information.

client_user_idstringrequired
A unique ID that identifies the end user in your system. Either a `user_id` or the `client_user_id` must be provided. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
businessobjectoptional
Business information provided in the verification request
client_idstringoptional
Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
secretstringoptional
Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.

1 status code
200Returns the created business verification, including its identifier, timestamps, status, search terms, KYB results, risk assessment, digital presence results, request identifier, and shareable URL.
idstringrequired
ID of the associated business verification.
client_user_idstringrequired
A unique ID that identifies the end user in your system. Either a `user_id` or the `client_user_id` must be provided. This ID can also be used to associate user-specific data from other Plaid products. Financial Account Matching requires this field and the `/link/token/create` `client_user_id` to be consistent. Personally identifiable information, such as an email address or phone number, should not be used in the `client_user_id`.
created_atstringrequired
An ISO8601 formatted timestamp.
completed_atstringrequired
An ISO8601 formatted timestamp.
redacted_atstringrequired
An ISO8601 formatted timestamp.
statusstringrequired
Status of the overall business verification
Allowed:activesuccessfailed
search_termsobjectrequired
The business information that was used to perform the verification search
kyb_checkobjectrequired
Results from the KYB (Know Your Business) identity verification check
risk_checkobjectrequired
Results from the business risk assessment check
digital_presence_checkobjectrequired
Results from the digital presence check.
request_idstringrequired
A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.
shareable_urlstringrequired
A shareable URL that can be sent directly to the user to complete verification

Error handling

client_user_id is required. If supplied, business.name and business.alternative_name must contain 1 to 500 characters, business.website must be an HTTP or HTTPS URI, business.phone_number must use E.164 format, and business.email_address must be a valid RFC-compliant email address.