Skip to main content
Update a Business Representative
curl --request PATCH \
  --url https://api.spherepay.co/v2/business-representative/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": {
    "line1": "742 North Wabash Avenue",
    "line2": "Apt 4B",
    "city": "Chicago",
    "postalCode": "60611",
    "state": "IL",
    "country": "USA"
  },
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  }
}
'
{
  "id": "associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b",
  "customerId": "customer_2f283221a9d44ada800ac7f11f640402",
  "type": "individual",
  "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",
  "email": "james.wilson@acmecorp.example.com",
  "phone": "+13125559876",
  "representationDetails": {
    "roles": [
      "ubo"
    ],
    "ownershipPercentage": "50",
    "isControlPerson": true,
    "isSigner": true,
    "relationshipEstablishedAt": "2020-03-15",
    "title": "CEO"
  }
}
Update mutable fields on an existing business representative. Use this endpoint to correct or supplement information before the representative’s KYB verification is submitted — for example, to add a tax identification number, update a residential address, or adjust representation details such as title or ownership percentage. Only include fields you want to change; unspecified fields are left unchanged.

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"

Body

application/json
​
address
object

The address of the business representative. Required if personalInformation is provided.

Example:
{
  "line1": "742 North Wabash Avenue",
  "line2": "Apt 4B",
  "city": "Chicago",
  "postalCode": "60611",
  "state": "IL",
  "country": "USA"
}
​
personalInformation
object

Personal information including tax identification details for individual customers. When any tax identification field is provided, all tax identification fields (number, type, country) and address are required. Please refer to the Individual Verification Criteria for the full list of reference.

​
representationDetails
object

The representation details of the business representative.

Example:
{
  "roles": ["ubo"],
  "ownershipPercentage": "50",
  "isControlPerson": true,
  "isSigner": true,
  "relationshipEstablishedAt": "2020-03-15",
  "title": "CEO"
}

Response

​
id
string
required

Business Representative ID

Example:

"associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b"

​
customerId
string
required

Customer ID

Example:

"customer_2f283221a9d44ada800ac7f11f640402"

​
type
enum<string>
required

Customer type

Available options:
individual
Example:

"individual"

​
verificationProfiles
object[]
required

Array of verification profiles for the business representative.

Example:
[
  {
    "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
string
required

The date and time the business representative was created.

Example:

"2026-03-10T00:00:08.986Z"

​
updatedAt
string
required

The date and time the business representative was last updated.

Example:

"2026-03-10T00:00:08.986Z"

​
email
string

Email address

Example:

"james.wilson@acmecorp.example.com"

​
phone
string

Phone number

Example:

"+13125559876"

​
representationDetails
object

Representation details

Last modified on June 18, 2026