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

Devuelve los metadatos de una prueba y un downloadUrl firmado de corta duración para obtener el archivo.

* El host, la caducidad y la firma de downloadUrl están abreviados en el ejemplo.
* El acceso a los archivos se audita con el usuario de tu token de acceso.
* Si la URL caduca, vuelva a llamar a este endpoint para obtener una nueva.

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/proofs/{proofId}
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/proofs/{proofId}:
    get:
      summary: Obtener una prueba
      operationId: get-proof
      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: proofId
          in: path
          description: ID de la prueba.
          required: true
          schema:
            type: string
            format: uuid
            examples:
              - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    examples:
                      - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    description: Identificador de prueba (proofId).
                  documentId:
                    type: string
                    examples:
                      - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                    format: uuid
                    description: Documento al que da soporte el archivo.
                  proofType:
                    type: string
                    examples:
                      - FRONT
                    enum:
                      - FRONT
                      - BACK
                      - SELFIE
                      - DOCUMENT
                      - OTHER
                    description: FRONT, BACK, SELFIE, DOCUMENT, OTHER.
                  fileName:
                    type: string
                    examples:
                      - id_front.jpg
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  mimeType:
                    type: string
                    examples:
                      - image/jpeg
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  sizeBytes:
                    type: integer
                    examples:
                      - 102400
                    description: >-
                      Metadatos del archivo tal como se cargaron. Verifica que
                      sizeBytes > 0 después de una carga.
                  verificationStatus:
                    type: string
                    examples:
                      - PENDING
                    enum:
                      - PENDING
                      - IN_REVIEW
                      - APPROVED
                      - REJECTED
                    description: >-
                      PENDING, IN_REVIEW, APPROVED, REJECTED. Establecido por
                      Localpayment Compliance.
                  verifiedBy:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  verifiedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  verificationReason:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Resultado de la verificación. verificationReason se
                      completa en caso de rechazo.
                  uploadedBy:
                    type: string
                    examples:
                      - '12345'
                    description: >-
                      Usuario de tu cuenta que subió el archivo (desde el token
                      de acceso) y hora de subida.
                  uploadedAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:13Z'
                    format: date-time
                    description: >-
                      Usuario de tu cuenta que subió el archivo (desde el token
                      de acceso) y hora de subida.
                  status:
                    type: string
                    examples:
                      - CURRENT
                    enum:
                      - CURRENT
                      - SUPERSEDED
                      - DELETED
                    description: >-
                      Ciclo de vida de la prueba: CURRENT (activa), SUPERSEDED
                      (reemplazada por una carga más reciente del mismo
                      proofType) o DELETED. Independiente de verificationStatus.
                  supersededAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: Establecido cuando se reemplazó la prueba.
                  supersededBy:
                    type:
                      - string
                      - 'null'
                    description: Establecido cuando se reemplazó la prueba.
                  replacedByProofId:
                    type:
                      - string
                      - 'null'
                    format: uuid
                    description: Establecido cuando se reemplazó la prueba.
                  deletedAt:
                    type:
                      - string
                      - 'null'
                    format: date-time
                    description: Establecido cuando se eliminó la prueba.
                  deletedBy:
                    type:
                      - string
                      - 'null'
                    description: Establecido cuando se eliminó la prueba.
                  inVerification:
                    type: boolean
                    examples:
                      - true
                    description: >-
                      verdadero mientras la prueba sea parte de una revisión en
                      curso (entidad IN_REVIEW); no se puede reemplazar ni
                      eliminar entonces.
                  downloadUrl:
                    type: string
                    examples:
                      - >-
                        https://files.example.com/<object-path>?expires=600&signature=<redacted>
                    description: >-
                      URL firmada válida durante 10 minutos. Solicítala justo
                      antes de descargar; no la guardes.
              examples:
                Example 1:
                  value:
                    id: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                    proofType: FRONT
                    fileName: id_front.jpg
                    mimeType: image/jpeg
                    sizeBytes: 102400
                    verificationStatus: PENDING
                    verifiedBy: null
                    verifiedAt: null
                    verificationReason: null
                    uploadedBy: '12345'
                    uploadedAt: '2024-01-15T17:03:13Z'
                    status: CURRENT
                    supersededAt: null
                    supersededBy: null
                    replacedByProofId: null
                    deletedAt: null
                    deletedBy: null
                    inVerification: true
                    downloadUrl: >-
                      https://files.example.com/<object-path>?expires=600&signature=<redacted>
        '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/proofs/2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    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/proofs/2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '404':
          description: >-
            No encontrado. PROOF_NOT_FOUND: La prueba 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 - PROOF_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: The proof does not exist or belongs to another merchant.
                    instance: /api/entity/v1/proofs/2c4c2f74-7179-4113-83fb-f11dbce9e07d
                    code: PROOF_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.