New: Streamlined onboarding defaults  View changelog →
Business Representative

List Business Representatives

List all business representatives for a customer

GET
/v2/business-representative

Authorization

AuthorizationBearer <token>

In: header

Query Parameters

pagestring

Page number of the list (default: 1)

Default"1"
limitstring

Number of items per page (default: 10)

Default"10"
customerId?string
Length1 <= length

Response Body

curl -X GET "https://api.spherepay.co/v2/business-representative?page=1&limit=10&customerId=string"
{
  "data": [
    {
      "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrevious": false
  }
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}