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

# Listar entidades

Devuelve una lista paginada de tus entidades. Las entidades cerradas se excluyen a menos que includeClosed=true.

* Los valores de enumeración no válidos en los filtros devuelven 400 VALIDATION\_ERROR.
* El filtrado por nombre no está disponible.

Los errores usan `application/problem+json` con un `code` estable. Catálogo completo: [Estados de entidad 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
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:
    get:
      summary: Listar entidades
      operationId: list-entities
      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: type
          in: query
          description: INDIVIDUAL o COMPANY.
          required: false
          schema:
            type: string
            enum:
              - INDIVIDUAL
              - COMPANY
        - name: status
          in: query
          description: Estado de la entidad.
          required: false
          schema:
            type: string
            enum:
              - PENDING_KYC
              - IN_REVIEW
              - ACTIVE
              - REJECTED
              - BLOCKED
              - CLOSED
        - name: externalId
          in: query
          description: Coincidencia exacta con tu identificador.
          required: false
          schema:
            type: string
        - name: documentId
          in: query
          description: >-
            Número de documento de cualquier documento declarado (coincidencia
            exacta).
          required: false
          schema:
            type: string
        - name: documentationStatus
          in: query
          description: NO_FILES, PARTIAL, COMPLETE.
          required: false
          schema:
            type: string
            enum:
              - NO_FILES
              - PARTIAL
              - COMPLETE
        - name: createdFrom
          in: query
          description: ISO 8601, inclusive.
          required: false
          schema:
            type: string
            format: date-time
        - name: createdTo
          in: query
          description: ISO 8601, inclusive.
          required: false
          schema:
            type: string
            format: date-time
        - name: includeClosed
          in: query
          description: 'Incluir entidades CLOSED. Valor predeterminado: false.'
          required: false
          schema:
            type: boolean
        - name: pageIndex
          in: query
          description: 'Página con índice base cero. Valor predeterminado: 0.'
          required: false
          schema:
            type: integer
        - name: pageSize
          in: query
          description: >-
            Valor predeterminado: 20, máximo: 200 (los valores superiores están
            limitados).
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pageIndex:
                    type: integer
                    examples:
                      - 0
                    description: Datos de paginación.
                  pageSize:
                    type: integer
                    examples:
                      - 20
                    description: Datos de paginación.
                  totalElements:
                    type: integer
                    examples:
                      - 1
                    description: Datos de paginación.
                  totalPages:
                    type: integer
                    examples:
                      - 1
                    description: Datos de paginación.
                  content:
                    type: array
                    items:
                      type: object
                      properties:
                        internalId:
                          type: string
                          examples:
                            - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                          format: uuid
                        externalId:
                          type: string
                          examples:
                            - 550e8400-e29b-41d4-a716-446655440000
                        type:
                          type: string
                          examples:
                            - INDIVIDUAL
                          enum:
                            - INDIVIDUAL
                            - COMPANY
                        status:
                          type: string
                          examples:
                            - PENDING_KYC
                          enum:
                            - PENDING_KYC
                            - IN_REVIEW
                            - ACTIVE
                            - REJECTED
                            - BLOCKED
                            - CLOSED
                          description: >-
                            Estado de la entidad. Consulta Estados de las
                            entidades y códigos de error.
                        name:
                          type: string
                          examples:
                            - Jane
                        lastname:
                          type: string
                          examples:
                            - Doe
                        birthdate:
                          type: string
                          examples:
                            - '1990-01-15'
                          format: date
                        gender:
                          type:
                            - string
                            - 'null'
                        nationality:
                          type: string
                          examples:
                            - BRA
                        birthCountry:
                          type: string
                          examples:
                            - BRA
                        residenceCountry:
                          type: string
                          examples:
                            - BRA
                        occupation:
                          type:
                            - string
                            - 'null'
                        isPep:
                          type: boolean
                          examples:
                            - false
                        incorporationDate:
                          type:
                            - string
                            - 'null'
                          format: date
                        incorporationCountry:
                          type:
                            - string
                            - 'null'
                        website:
                          type:
                            - string
                            - 'null'
                        legalRepresentativeName:
                          type:
                            - string
                            - 'null'
                        email:
                          type: string
                          examples:
                            - jane.doe@example.com
                        phone:
                          type: object
                          properties:
                            countryCode:
                              type: string
                              examples:
                                - '55'
                            areaCode:
                              type: string
                              examples:
                                - '11'
                            number:
                              type: string
                              examples:
                                - '999990001'
                        address:
                          type: object
                          properties:
                            street:
                              type: string
                              examples:
                                - Rua Exemplo
                            city:
                              type: string
                              examples:
                                - São Paulo
                            state:
                              type: string
                              examples:
                                - SP
                            zipCode:
                              type: string
                              examples:
                                - 01310-100
                            number:
                              type: string
                              examples:
                                - '123'
                            comment:
                              type:
                                - string
                                - 'null'
                            country:
                              type: string
                              examples:
                                - BRA
                            line2:
                              type:
                                - string
                                - 'null'
                            line3:
                              type:
                                - string
                                - 'null'
                        attributes:
                          type:
                            - object
                            - 'null'
                        documentationStatus:
                          type: string
                          examples:
                            - NO_FILES
                          enum:
                            - NO_FILES
                            - PARTIAL
                            - COMPLETE
                        document:
                          type: object
                          properties:
                            documentId:
                              type: string
                              examples:
                                - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                              format: uuid
                            entityId:
                              type: string
                              examples:
                                - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                              format: uuid
                            type:
                              type: string
                              examples:
                                - CPF
                              enum:
                                - DNI
                                - NATIONAL_ID
                                - DRIVER_LICENSE
                                - PASSPORT
                                - CE
                                - CC
                                - CUIT
                                - CUIL
                                - RFC
                                - CURP
                                - CPF
                                - CNPJ
                                - RUC
                                - NIT
                                - TAX_ID
                                - ARTICLES_OF_INCORPORATION
                                - POWER_OF_ATTORNEY
                                - TAX_CERTIFICATE
                                - PAYSLIP
                                - ARCA_REGISTRATION
                                - PROOF_OF_ADDRESS
                                - PROOF_OF_FUNDS
                                - OTHER
                            id:
                              type: string
                              examples:
                                - '00000000000'
                            issuingCountry:
                              type: string
                              examples:
                                - BRA
                            issueDate:
                              type:
                                - string
                                - 'null'
                              format: date
                            expirationDate:
                              type:
                                - string
                                - 'null'
                              format: date
                            isPrimary:
                              type: boolean
                              examples:
                                - true
                            status:
                              type: string
                              examples:
                                - PENDING
                              enum:
                                - PENDING
                                - VERIFIED
                                - REJECTED
                                - EXPIRED
                              description: >-
                                Estado derivado del documento: EXPIRED si
                                expirationDate ha pasado, REJECTED si alguna
                                prueba activa está rechazada, VERIFIED si todas
                                las pruebas activas están aprobadas; de lo
                                contrario, PENDING.
                            metadata:
                              type:
                                - object
                                - 'null'
                            proofs:
                              type: array
                              items:
                                type: object
                            createdAt:
                              type: string
                              examples:
                                - '2024-01-15T17:03:10Z'
                              format: date-time
                            updatedAt:
                              type: string
                              examples:
                                - '2024-01-15T17:03:10Z'
                              format: date-time
                        documents:
                          type: array
                          items:
                            type: object
                        version:
                          type: integer
                          examples:
                            - 0
                        createdAt:
                          type: string
                          examples:
                            - '2024-01-15T17:03:10Z'
                          format: date-time
                        updatedAt:
                          type: string
                          examples:
                            - '2024-01-15T17:03:10Z'
                          format: date-time
                        customFieldSchemaVersion:
                          type:
                            - integer
                            - 'null'
                    description: >-
                      Entidades, misma forma que Obtener una Entidad. uboCount y
                      uboRequirementMet son nulos en los listados.
              examples:
                Example 1:
                  value:
                    pageIndex: 0
                    pageSize: 20
                    totalElements: 1
                    totalPages: 1
                    content:
                      - internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                        externalId: 550e8400-e29b-41d4-a716-446655440000
                        type: INDIVIDUAL
                        status: PENDING_KYC
                        name: Jane
                        lastname: Doe
                        birthdate: '1990-01-15'
                        gender: null
                        nationality: BRA
                        birthCountry: BRA
                        residenceCountry: BRA
                        occupation: null
                        isPep: false
                        incorporationDate: null
                        incorporationCountry: null
                        website: null
                        legalRepresentativeName: null
                        email: jane.doe@example.com
                        phone:
                          countryCode: '55'
                          areaCode: '11'
                          number: '999990001'
                        address:
                          street: Rua Exemplo
                          city: São Paulo
                          state: SP
                          zipCode: 01310-100
                          number: '123'
                          comment: null
                          country: BRA
                          line2: null
                          line3: null
                        attributes: null
                        documentationStatus: NO_FILES
                        document:
                          documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                          entityId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                          type: CPF
                          id: '00000000000'
                          issuingCountry: BRA
                          issueDate: null
                          expirationDate: null
                          isPrimary: true
                          status: PENDING
                          metadata: null
                          proofs: []
                          createdAt: '2024-01-15T17:03:10Z'
                          updatedAt: '2024-01-15T17:03:10Z'
                        documents: []
                        version: 0
                        createdAt: '2024-01-15T17:03:10Z'
                        updatedAt: '2024-01-15T17:03:10Z'
                        customFieldSchemaVersion: null
        '400':
          description: >-
            Solicitud incorrecta. VALIDATION_ERROR: Falta un campo, encabezado,
            ruta o parámetro de consulta, es desconocido o no válido. details[]
            muestra el campo y el problema.
          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 - VALIDATION_ERROR:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      A field, header, path or query parameter is missing,
                      unknown or invalid. details[] lists field and issue.
                    instance: /api/entity/v1/entities
                    code: VALIDATION_ERROR
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: externalId
                        issue: REQUIRED
        '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
                    code: UNAUTHORIZED
                    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.