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

# Obtener un documento

Devuelve un documento declarado con su estado derivado y sus pruebas activas.

* El primer ejemplo muestra un documento VERIFIED (su única prueba activa está APPROVED); el segundo, uno REJECTED, con el motivo en la prueba.

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}/documents/{docId}
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}/documents/{docId}:
    get:
      summary: Obtener un documento
      operationId: get-entity-document
      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
        - name: docId
          in: path
          description: documentId del documento.
          required: true
          schema:
            type: string
            format: uuid
            examples:
              - e0ea9515-442e-4bc5-bc82-b8d278255c37
      responses:
        '200':
          description: OK.
          content:
            application/json:
              schema:
                type: object
                properties:
                  documentId:
                    type: string
                    examples:
                      - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                    format: uuid
                    description: >-
                      Identificador del documento (docId). Úsalo para cargar y
                      listar pruebas.
                  entityId:
                    type: string
                    examples:
                      - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    format: uuid
                    description: Entidad propietaria.
                  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: Tipo de documento.
                  id:
                    type: string
                    examples:
                      - '00000000000'
                    description: Número de documento según lo declarado.
                  issuingCountry:
                    type: string
                    examples:
                      - BRA
                    description: Emisión de datos según lo declarado.
                  issueDate:
                    type:
                      - string
                      - 'null'
                    format: date
                    description: Emisión de datos según lo declarado.
                  expirationDate:
                    type:
                      - string
                      - 'null'
                    format: date
                    description: Emisión de datos según lo declarado.
                  isPrimary:
                    type: boolean
                    examples:
                      - true
                    description: Documento identificativo de la entidad.
                  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.
                  metadata:
                    type:
                      - object
                      - 'null'
                    description: Metadatos de formato libre.
                  proofs:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          examples:
                            - 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                          description: Número de documento según lo declarado.
                        documentId:
                          type: string
                          examples:
                            - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                          format: uuid
                          description: >-
                            Identificador del documento (docId). Úsalo para
                            cargar y listar pruebas.
                        proofType:
                          type: string
                          examples:
                            - FRONT
                          enum:
                            - FRONT
                            - BACK
                            - SELFIE
                            - DOCUMENT
                            - OTHER
                        fileName:
                          type: string
                          examples:
                            - id_front.jpg
                        mimeType:
                          type: string
                          examples:
                            - image/jpeg
                        sizeBytes:
                          type: integer
                          examples:
                            - 102400
                        verificationStatus:
                          type: string
                          examples:
                            - APPROVED
                          enum:
                            - PENDING
                            - IN_REVIEW
                            - APPROVED
                            - REJECTED
                        verifiedBy:
                          type: string
                          examples:
                            - '67890'
                        verifiedAt:
                          type: string
                          examples:
                            - '2024-01-15T17:03:20Z'
                          format: date-time
                        verificationReason:
                          type:
                            - string
                            - 'null'
                        uploadedBy:
                          type: string
                          examples:
                            - '12345'
                        uploadedAt:
                          type: string
                          examples:
                            - '2024-01-15T17:03:13Z'
                          format: date-time
                        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
                        supersededBy:
                          type:
                            - string
                            - 'null'
                        replacedByProofId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                        deletedAt:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        deletedBy:
                          type:
                            - string
                            - 'null'
                        inVerification:
                          type: boolean
                          examples:
                            - false
                    description: >-
                      Pruebas vigentes del documento (los archivos reemplazados
                      no se muestran).
                  createdAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:10Z'
                    format: date-time
                  updatedAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:15Z'
                    format: date-time
              examples:
                Example 1:
                  value:
                    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: VERIFIED
                    metadata: null
                    proofs:
                      - id: 2c4c2f74-7179-4113-83fb-f11dbce9e07d
                        documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                        proofType: FRONT
                        fileName: id_front.jpg
                        mimeType: image/jpeg
                        sizeBytes: 102400
                        verificationStatus: APPROVED
                        verifiedBy: '67890'
                        verifiedAt: '2024-01-15T17:03:20Z'
                        verificationReason: null
                        uploadedBy: '12345'
                        uploadedAt: '2024-01-15T17:03:13Z'
                        status: CURRENT
                        supersededAt: null
                        supersededBy: null
                        replacedByProofId: null
                        deletedAt: null
                        deletedBy: null
                        inVerification: false
                    createdAt: '2024-01-15T17:03:10Z'
                    updatedAt: '2024-01-15T17:03:15Z'
                Example 2 - A document whose file was rejected:
                  value:
                    documentId: 0266257c-a2aa-49ac-99fe-b3882a51d750
                    entityId: 8f5b2c9a-1caf-4b2c-b085-82bbaead6ddd
                    type: NATIONAL_ID
                    id: 00.000.000-0
                    issuingCountry: BRA
                    issueDate: null
                    expirationDate: null
                    isPrimary: false
                    status: REJECTED
                    metadata: null
                    proofs:
                      - id: 931398af-9c77-4958-abf8-4c749147c508
                        documentId: 0266257c-a2aa-49ac-99fe-b3882a51d750
                        proofType: BACK
                        fileName: id_back.jpg
                        mimeType: image/jpeg
                        sizeBytes: 98304
                        verificationStatus: REJECTED
                        verifiedBy: '67890'
                        verifiedAt: '2024-01-15T17:20:34Z'
                        verificationReason: Illegible image
                        uploadedBy: '12345'
                        uploadedAt: '2024-01-15T17:19:49Z'
                        status: CURRENT
                        supersededAt: null
                        supersededBy: null
                        replacedByProofId: null
                        deletedAt: null
                        deletedBy: null
                        inVerification: false
                    createdAt: '2024-01-15T17:19:46Z'
                    updatedAt: '2024-01-15T17:19:46Z'
        '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/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37
                    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. DOCUMENT_NOT_FOUND: El documento no existe, fue
            eliminado 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/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37
                    code: ENTITY_NOT_FOUND
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
                Example 2 - DOCUMENT_NOT_FOUND:
                  value:
                    type: about:blank
                    title: Not found
                    status: 404
                    detail: >-
                      The document does not exist, was deleted, or belongs to
                      another merchant.
                    instance: >-
                      /api/entity/v1/entities/5aced5da-40c1-4bec-85ff-c8cd1bcb4526/documents/e0ea9515-442e-4bc5-bc82-b8d278255c37
                    code: DOCUMENT_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.