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

# Retrieve a Business Representative by ID

> Retrieve a business representative by their ID

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.


## OpenAPI

````yaml openapi/spherepay.yaml GET /v2/business-representative/{id}
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/{id}:
    get:
      summary: Get a Business Representative by ID
      description: Retrieve a business representative by their ID
      parameters:
        - name: id
          required: true
          in: path
          description: Business Representative ID
          schema:
            minLength: 1
            example: associatedPerson_d972d2f70b9f4d3c8d7cfb32593f395b
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessRepresentativeResponseDto'
        '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:
    BusinessRepresentativeResponseDto:
      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
    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

````