> ## 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.

# List All Business Representatives and UBOs

> List all business representatives for a customer

Retrieve a paginated list of all business representatives registered in your account. Use the `customerId` query parameter to scope results to the representatives of a specific business customer. The response includes each representative's identity details, ownership stake, roles, and the current state of their verification profile criteria — making this endpoint useful for tracking KYB progress across all UBOs.


## OpenAPI

````yaml openapi/spherepay.yaml GET /v2/business-representative
openapi: 3.0.0
info:
  title: ''
  description: ''
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.spherepay.co
    description: Production
security:
  - bearer: []
tags: []
paths:
  /v2/business-representative:
    get:
      summary: List Business Representatives
      description: List all business representatives for a customer
      parameters:
        - name: page
          required: true
          in: query
          description: 'Page number of the list (default: 1)'
          schema:
            default: '1'
            example: 1
            type: string
        - name: limit
          required: true
          in: query
          description: 'Number of items per page (default: 10)'
          schema:
            default: '10'
            example: 10
            type: string
        - name: customerId
          required: false
          in: query
          schema:
            minLength: 1
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBusinessRepresentativesResponseDto'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Bad Request:
                  summary: Bad Request
                  value:
                    status: 400
                    detail: Invalid request parameters
                    code: address/invalid
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Not Found:
                  summary: Not Found
                  value:
                    status: 404
                    detail: Resource not found
                    code: resource/not-found
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
        '422':
          description: Unprocessable Entity - Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetailsDto'
              examples:
                Validation Error:
                  summary: Validation Error
                  value:
                    status: 422
                    detail: Validation failed
                    code: validation/failed
                    correlationId: 28c61e885c6e5eaa78c1a2183a9b883c
                    errors:
                      - detail: Invalid email format
                        pointer: /email
                      - detail: Name is required
                        pointer: /name
components:
  schemas:
    ListBusinessRepresentativesResponseDto:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                description: Business Representative ID
                example: associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b
                type: string
              customerId:
                description: Customer ID
                example: customer_2f283221a9d44ada800ac7f11f640402
                type: string
              type:
                description: Customer type
                example: individual
                type: string
                enum:
                  - individual
              email:
                description: Email address
                example: james.wilson@acmecorp.example.com
                type: string
              phone:
                description: Phone number
                example: '+13125559876'
                type: string
              representationDetails:
                description: Representation details
                type: object
                properties:
                  roles:
                    description: The roles of the business representative.
                    example:
                      - ubo
                    type: array
                    items:
                      type: string
                      enum:
                        - ubo
                  ownershipPercentage:
                    description: The ownership percentage of the business representative.
                    example: '50'
                    type: string
                  isControlPerson:
                    description: >-
                      Whether the business representative has control over the
                      company.
                    example: true
                    type: boolean
                  isSigner:
                    description: >-
                      Whether the business representative is a signer on the
                      company's documents.
                    example: true
                    type: boolean
                  relationshipEstablishedAt:
                    description: >-
                      The date the business representative was established in
                      the company.
                    example: '2020-03-15'
                    type: string
                  title:
                    description: The title of the business representative.
                    example: CEO
                    type: string
                required:
                  - roles
              verificationProfiles:
                description: >-
                  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: []
                type: array
                items:
                  type: object
                  properties:
                    name:
                      description: The name of the verification profile.
                      example: kyc_profile_a
                      type: string
                      enum:
                        - kyc_profile_a
                        - kyb_profile_a
                        - ubo_kyc_profile_a
                        - kyc_profile_b
                        - kyb_profile_b
                        - kyb_profile_c
                        - kyc_profile_c
                        - ubo_kyc_profile_c
                    status:
                      description: The status of the verification profile.
                      example: incomplete
                      type: string
                      enum:
                        - incomplete
                        - pending
                        - approved
                        - rejected
                        - resubmission_required
                    criteria:
                      description: The criteria for the verification profile.
                      example:
                        complete:
                          - email_address
                          - phone_number
                          - residential_address
                          - tax_identification_number
                        pending: []
                        required:
                          - identity_document
                          - liveness_report_document
                        errors: []
                      type: object
                      properties:
                        complete:
                          description: Completed fields.
                          example:
                            - email_address
                            - phone_number
                            - residential_address
                            - tax_identification_number
                          type: array
                          items:
                            type: string
                        pending:
                          description: >-
                            Pending fields. These fields are currently being
                            verified.
                          example: []
                          type: array
                          items:
                            type: string
                        required:
                          description: >-
                            Required fields. These fields are required to be
                            completed before the verification profile can be
                            approved.
                          example:
                            - identity_document
                            - liveness_report_document
                          type: array
                          items:
                            type: string
                        errors:
                          description: The errors that occurred while verifying the fields.
                          example: []
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                enum:
                                  - email_verification
                                  - phone_verification
                                  - residential_address
                                  - identity_document
                                  - tax_identification_number
                                  - liveness_check
                                  - terms_of_service
                                  - email_address
                                  - phone_number
                                  - master_service_agreement
                                  - legal_name
                                  - trade_name
                                  - entity_type
                                  - entity_type_description
                                  - description
                                  - registered_address
                                  - operating_address
                                  - business_representatives
                                  - naics_code
                                  - website
                                  - incorporated_on
                                  - identification_number
                                  - registration_number
                                  - estimated_annual_revenue
                                  - expected_monthly_payments
                                  - account_purpose
                                  - account_purpose_description
                                  - source_of_funds
                                  - source_of_funds_description
                                  - is_dao
                                  - regulated_activities
                                  - regulated_activities_description
                                  - participates_in_regulated_financial_activity
                                  - regulated_financial_activity_description
                                  - money_services_description
                                  - compliance_screening_explanation
                                  - operates_in_prohibited_countries
                                  - incorporation_cert_document
                                  - incorporation_articles_document
                                  - shareholder_registry_document
                                  - proof_of_nature_of_business_document
                                  - proof_of_address_document
                                  - liveness_report_document
                                  - ownership_percentage
                                  - is_control_person
                                  - is_signer
                                  - relationship_established_at
                                  - title
                                  - sex
                                  - country_of_birth
                                  - nationality
                                  - middle_name
                                  - occupation_soc_code
                                  - w8_ben_document
                                  - w9_document
                                  - w8_ben_e_document
                                  - corporate_resolution_document
                                  - source_of_funds_document
                                  - financial_statements_document
                                  - bank_statement_document
                                  - regulated_activity_document
                                  - flow_of_funds_document
                                  - kyc_b_approval
                                  - kyb_b_approval
                              detail:
                                type: string
                            required:
                              - name
                      required:
                        - complete
                        - pending
                        - required
                        - errors
                  required:
                    - name
                    - status
              createdAt:
                description: The date and time the business representative was created.
                example: '2026-03-10T00:00:08.986Z'
                type: string
              updatedAt:
                description: >-
                  The date and time the business representative was last
                  updated.
                example: '2026-03-10T00:00:08.986Z'
                type: string
            required:
              - id
              - customerId
              - type
              - verificationProfiles
              - createdAt
              - updatedAt
        pagination:
          type: object
          properties:
            page:
              description: Current page number
              example: 1
              type: number
            limit:
              description: Number of items per page
              example: 10
              type: number
              minimum: 1
              exclusiveMinimum: false
              maximum: 100
              exclusiveMaximum: false
            total:
              description: Total number of items
              example: 1
              type: number
            totalPages:
              description: Total number of pages
              example: 1
              type: number
            hasNext:
              description: Whether there is a next page
              example: false
              type: boolean
            hasPrevious:
              description: Whether there is a previous page
              example: false
              type: boolean
          required:
            - page
            - limit
            - total
            - totalPages
            - hasNext
            - hasPrevious
      required:
        - data
        - pagination
    ProblemDetailsDto:
      type: object
      properties:
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        code:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              detail:
                type: string
              pointer:
                type: string
              parameter:
                type: string
              header:
                type: string
            required:
              - detail
        correlationId:
          type: string
      required:
        - status
        - detail
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````