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

# Obtén el estado KYC

Devuelve un árbol compacto del estado de la revisión: estado de la entidad, cobertura de la documentación, el estado de cada documento y de cada prueba activa, y el motivo del último cambio de estado. Úsalo para seguir la revisión que realiza Localpayment.

* El ejemplo principal se capturó mientras el caso estaba IN\_REVIEW con ambos archivos ya aprobados; el segundo, justo después de la carga, con los archivos aún en PENDING.
* documentationStatus: COMPLETE significa que cada documento tiene un archivo; no significa que los archivos hayan sido aprobados. La aprobación se refleja en documents\[].status = VERIFIED y proofs\[].verificationStatus = APPROVED.

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/{entityId}/kyc-status
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/{entityId}/kyc-status:
    get:
      summary: Obtén el estado KYC
      operationId: get-kyc-status
      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: entityId
          in: path
          description: internalId de la entidad.
          required: true
          schema:
            type: string
            examples:
              - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
            format: uuid
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  entityId:
                    type: string
                    examples:
                      - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    format: uuid
                    description: Entidad.
                  status:
                    type: string
                    examples:
                      - IN_REVIEW
                    enum:
                      - PENDING_KYC
                      - IN_REVIEW
                      - ACTIVE
                      - REJECTED
                      - BLOCKED
                      - CLOSED
                    description: >-
                      Estado de la entidad. Consulta Estados de las entidades y
                      códigos de error.
                  documentationStatus:
                    type: string
                    examples:
                      - COMPLETE
                    enum:
                      - NO_FILES
                      - PARTIAL
                      - COMPLETE
                    description: NO_FILES, PARTIAL, COMPLETE.
                  statusReason:
                    type: string
                    examples:
                      - Review started
                    description: >-
                      Motivo del último cambio de estado, o nulo. Cuando
                      Localpayment devuelve la entidad a PENDING_KYC, indica qué
                      corregir.
                  documents:
                    type: array
                    items:
                      type: object
                      properties:
                        documentId:
                          type: string
                          examples:
                            - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                          format: uuid
                          description: Documento y su estado derivado.
                        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
                          description: Documento y su estado derivado.
                        status:
                          type: string
                          examples:
                            - VERIFIED
                          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.
                        proofs:
                          type: array
                          items:
                            type: object
                            properties:
                              proofId:
                                type: string
                                examples:
                                  - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                                format: uuid
                                description: Pruebas activas y su estado de verificación.
                              verificationStatus:
                                type: string
                                examples:
                                  - APPROVED
                                enum:
                                  - PENDING
                                  - IN_REVIEW
                                  - APPROVED
                                  - REJECTED
                                description: Pruebas activas y su estado de verificación.
              examples:
                Example 1:
                  value:
                    entityId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    status: IN_REVIEW
                    documentationStatus: COMPLETE
                    statusReason: Review started
                    documents:
                      - documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                        type: CPF
                        status: VERIFIED
                        proofs:
                          - proofId: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                            verificationStatus: APPROVED
                      - documentId: e0ea9515-442e-4bc5-bc82-b8d278255c37
                        type: PROOF_OF_ADDRESS
                        status: VERIFIED
                        proofs:
                          - proofId: acb78b3f-fe18-4094-b6a9-2107f502d709
                            verificationStatus: APPROVED
                Example 2 - Right after upload, before the review starts:
                  value:
                    entityId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    status: PENDING_KYC
                    documentationStatus: COMPLETE
                    statusReason: null
                    documents:
                      - documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                        type: CPF
                        status: PENDING
                        proofs:
                          - proofId: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                            verificationStatus: PENDING
                      - documentId: e0ea9515-442e-4bc5-bc82-b8d278255c37
                        type: PROOF_OF_ADDRESS
                        status: PENDING
                        proofs:
                          - proofId: acb78b3f-fe18-4094-b6a9-2107f502d709
                            verificationStatus: PENDING
        '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/5aced5da-40c1-4bec-85ff-c8cd1bcb4526/kyc-status
                    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/5aced5da-40c1-4bec-85ff-c8cd1bcb4526/kyc-status
                    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.