> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de beneficiarios finales de una empresa

Enumera los vínculos UBO activos de una empresa, ordenados por fecha de creación. Los vínculos finalizados se incluyen con includeEnded=true.

* Las respuestas contienen solo identificadores; consulta a cada persona con Obtener una entidad.

Los errores usan `application/problem+json` con un `code` estable. Catálogo completo: [Estados de entidades y códigos de error](https://docs.localpayment.com/es/reference/entity-statuses-and-error-codes.md).


## OpenAPI

````yaml openapi/es/localpayment.json GET /api/entity/v1/entities/{companyId}/ubos
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/entity/v1/entities/{companyId}/ubos:
    get:
      summary: Listar UBO de una empresa
      operationId: list-company-ubos
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token). Tu cuenta de
            comerciante y el usuario que actúa se determinan a partir de él.
          required: true
          schema:
            type: string
            examples:
              - Bearer <your_access_token>
        - name: X-Correlation-ID
          in: header
          description: >-
            Identificador de seguimiento (UUID). Se incluye en la respuesta;
            Localpayment lo genera si no está presente.
          required: false
          schema:
            type: string
            examples:
              - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
        - name: companyId
          in: path
          description: internalId de la COMPANY.
          required: true
          schema:
            type: string
            examples:
              - 7c9e6679-7425-40de-944b-e07fc1f90ae7
            format: uuid
        - name: includeEnded
          in: query
          description: >-
            Incluir enlaces cuyo validTo haya pasado o que hayan finalizado.
            Valor predeterminado: falso.
          required: false
          schema:
            type: boolean
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          examples:
                            - 4584b476-ccc6-4e98-be40-0c5082748e35
                        companyId:
                          type: string
                          examples:
                            - 7c9e6679-7425-40de-944b-e07fc1f90ae7
                          format: uuid
                        personId:
                          type: string
                          examples:
                            - c1e384f5-ae1c-475e-9e64-a0abe533a96f
                          format: uuid
                        ownershipPercentage:
                          type:
                            - number
                            - 'null'
                          examples:
                            - 60
                        controlRole:
                          type: string
                          examples:
                            - CEO
                        validFrom:
                          type: string
                          examples:
                            - '2024-01-15'
                          format: date
                        validTo:
                          type:
                            - string
                            - 'null'
                          format: date
                        createdAt:
                          type: string
                          examples:
                            - '2024-01-15T17:20:47Z'
                          format: date-time
                    description: Enlaces UBO, misma forma que Enlace a UBO.
              examples:
                Example 1:
                  value:
                    items:
                      - id: 4584b476-ccc6-4e98-be40-0c5082748e35
                        companyId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        personId: c1e384f5-ae1c-475e-9e64-a0abe533a96f
                        ownershipPercentage: 60
                        controlRole: CEO
                        validFrom: '2024-01-15'
                        validTo: null
                        createdAt: '2024-01-15T17:20:47Z'
                      - id: 2c203b2b-5f92-427d-a75f-92981e2719bf
                        companyId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        personId: 8f5b2c9a-1caf-4b2c-b085-82bbaead6ddd
                        ownershipPercentage: 40
                        controlRole: PARTNER
                        validFrom: '2023-06-01'
                        validTo: null
                        createdAt: '2024-01-15T17:20:48Z'
                Example 2 - With includeEnded=true after one link was ended:
                  value:
                    items:
                      - id: 4584b476-ccc6-4e98-be40-0c5082748e35
                        companyId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        personId: c1e384f5-ae1c-475e-9e64-a0abe533a96f
                        ownershipPercentage: 55.5
                        controlRole: null
                        validFrom: '2024-01-15'
                        validTo: null
                        createdAt: '2024-01-15T17:20:47Z'
                      - id: 2c203b2b-5f92-427d-a75f-92981e2719bf
                        companyId: 7c9e6679-7425-40de-944b-e07fc1f90ae7
                        personId: 8f5b2c9a-1caf-4b2c-b085-82bbaead6ddd
                        ownershipPercentage: 40
                        controlRole: PARTNER
                        validFrom: '2023-06-01'
                        validTo: '2024-01-15'
                        createdAt: '2024-01-15T17:20:48Z'
        '401':
          description: >-
            No autorizado. UNAUTHORIZED: Falta el token de acceso o no es
            válido.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNAUTHORIZED:
                  value:
                    type: about:blank
                    title: Unauthorized
                    status: 401
                    detail: Missing or invalid access token.
                    instance: >-
                      /api/entity/v1/entities/7c9e6679-7425-40de-944b-e07fc1f90ae7/ubos
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '404':
          description: >-
            No encontrado. ENTITY_NOT_FOUND: La entidad no existe o pertenece a
            otro comerciante.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - ENTITY_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: The entity does not exist or belongs to another merchant.
                    instance: >-
                      /api/entity/v1/entities/7c9e6679-7425-40de-944b-e07fc1f90ae7/ubos
                    code: ENTITY_NOT_FOUND
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.