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

# Recuperar un Representante Empresarial por ID

> Retrieve a business representative by their ID

Recupera el perfil completo de un representante empresarial único por su ID. La respuesta incluye los datos de contacto del representante, participación de propiedad, roles asignados y un desglose de sus criterios de verificación KYB — mostrando qué requisitos están completos, cuáles siguen siendo necesarios y cualquier error que deba resolverse antes de que el representante pueda ser aprobado.


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

````