Skip to main content
Get a Business Representative by ID
curl --request GET \
  --url https://api.spherepay.co/v2/business-representative/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
  }
}
Retrieve the full profile of a single business representative by their ID. The response includes the representative’s contact details, ownership stake, assigned roles, and a breakdown of their KYB verification criteria — showing which requirements are complete, which are still required, and any errors that need to be resolved before the representative can be approved.

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

​
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