Skip to main content
Generate Face Verification Link for Business Representative
curl --request POST \
  --url https://api.spherepay.co/v2/business-representative/{id}/face-verification-link \
  --header 'Authorization: Bearer <token>'
{
  "url": "https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx",
  "expiresAt": "2026-03-09T20:46:31.305Z"
}
Generate a Sumsub face liveness verification link for a business representative (UBO). After calling this endpoint, redirect the representative to the returned url so they can complete the face liveness check as part of KYB verification. The link expires at the time indicated by expiresAt — if the representative has not completed liveness by that time, call this endpoint again to get a fresh link.
This endpoint targets a business representative, not a customer. Use the representative’s ID (prefixed associatedPerson_) as the path parameter, not the parent business customer’s ID.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Business Representative ID

Minimum string length: 1
Example:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

Response

​
url
string
required

Hosted face verification URL

Example:

"https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx"

​
expiresAt
string
required

ISO 8601 formatted date and time of the face verification URL expiration

Example:

"2026-03-09T20:46:31.305Z"

Last modified on June 18, 2026