Verify a customer's identity
Initiate identity verification and run the specified identity checks.
Verifying a personal customer requires that the following fields already be set:
first_namelast_namedobemailphone_numberlegal_addressssn
Verifying a business customer requires that the following fields already be set:
entity_namelegal_address
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
An idempotency key is an arbitrary unique value generated by client to detect subsequent retries of the same request. It is recommended that a UUID or a similar random identifier be used as an idempotency key. A different key must be used for each request, unless it is a retry.
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
Body
Whether this customer has consented to be verified.
Business ID for the application. An application must have either a Business or a customer associated with it.
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
Whether this verification request was initiated by the customer.
The customer's IP address.
"140.151.183.216"
The ID of the uploaded government-issued identification document provided by the Socure SDK.
"1ab2c3de-fg45-6789-a01b-23c45678defg"
Unique ID for the person. Exactly one of person_id or business_id must be set.
"7d943c51-e4ff-4e57-9558-08cab6b963c7"
Response
Created identity request.
The result of a KYC/KYB verification. One of the following:
UNVERIFIEDโ verification has not been completed for this customer.PENDINGโ verification is in progress for this customer.PROVISIONALโ partially verified or verified with restrictions.ACCEPTEDโ the customer has been verified.REVIEWโ verification has run and issues have been identified and require review.REJECTEDโ the customer was rejected and should not be allowed to take certain actions e.g., open an account.
UNVERIFIED, PENDING, PROVISIONAL, ACCEPTED, REVIEW, REJECTED "ACCEPTED"
Array of verification results.
If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.
"a8937a0d"

