Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt

Use this file to discover all available pages before exploring further.

Register a business representative or Ultimate Beneficial Owner (UBO) for a business customer. Each individual who directly or indirectly owns 25% or more of the business must be registered as a UBO before the business can be approved for transfers. You can also register control persons and authorized signers who do not meet the ownership threshold. After registration, complete the representative’s KYB by uploading their identity documents and, if using the Sphere-Managed model, generating a face verification link.
Any individual with an ownership stake of 25% or greater must be registered. If no single person meets this threshold, register the individual with the highest ownership stake or the person with significant management control.

​
Endpoint

POST https://api.spherepay.co/v2/business-representative

​
Authentication

All requests must include a Bearer token in the Authorization header. 
Authorization: Bearer <token>

​
Request parameters

​
customerId
string
required
The ID of the business customer this representative belongs to.
​
type
string
required
The type of business representative. Must be "individual".
​
email
string
required
The email address of the business representative. Maximum 254 characters.
​
phone
string
required
The phone number of the business representative in E.164 format (e.g., "+13125559876").
​
address
object
required
The residential address of the business representative.
​
personalInformation
object
Personal information including tax identification details. When any tax identification field is provided, all three fields (taxIdentificationNumber, taxIdentificationNumberType, taxIdentificationNumberCountry) and address are required.
​
representationDetails
object
Details about the representative’s role and ownership stake within the business.
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
    "type": "individual",
    "email": "james.wilson@acmecorp.example.com",
    "phone": "+13125559876",
    "address": {
      "line1": "233 South Wacker Drive",
      "city": "Chicago",
      "country": "USA"
    },
    "personalInformation": {
      "taxIdentificationNumber": "123456789",
      "taxIdentificationNumberType": "ssn",
      "taxIdentificationNumberCountry": "USA"
    },
    "representationDetails": {
      "roles": ["ubo"],
      "ownershipPercentage": "50",
      "isControlPerson": true,
      "isSigner": true,
      "relationshipEstablishedAt": "2020-03-15",
      "title": "CEO"
    }
  }'

​
Response fields

​
id
string
Unique identifier for the business representative (prefixed associatedPerson_).
​
customerId
string
The ID of the parent business customer.
​
type
string
The representative type ("individual").
​
email
string
The representative’s email address.
​
phone
string
The representative’s phone number.
​
representationDetails
object
The representative’s role, ownership percentage, and related details.
​
verificationProfiles
object[]
Array of verification profile objects showing which KYB criteria are complete, pending, required, or have errors.
​
createdAt
string
ISO 8601 timestamp of when the representative was created.
​
updatedAt
string
ISO 8601 timestamp of the last update.
{
  "id": "associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b",
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "representationDetails": {
    "roles": ["ubo"],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  },
  "verificationProfiles": [
    {
      "name": "ubo_kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [
          "email_address",
          "phone_number",
          "residential_address",
          "tax_identification_number",
          "ownership_percentage",
          "is_control_person",
          "is_signer",
          "relationship_established_at",
          "title"
        ],
        "pending": [],
        "required": [
          "identity_document",
          "liveness_report_document",
          "proof_of_address_document"
        ],
        "errors": []
      }
    }
  ],
  "createdAt": "2026-03-10T00:00:08.986Z",
  "updatedAt": "2026-03-10T00:00:08.986Z"
}
Last modified on May 12, 2026