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

# Obtener datos de prevalidacion de documentos

> Obtener fuentes para la pre-evaluación de documentos relacionados con una  empresa usando el id de la verificación.



## OpenAPI

````yaml /api-reference/openapi.yaml get /verifications/{verification-id}/sources
openapi: 3.0.0
info:
  title: Coleccion de API KYB MX
  description: >
    La Colección de API KYB MX proporciona puntos finales para crear y gestionar
    verificaciones de empresas en México. La verificación de empresas implica
    validar la información proporcionada por un cliente comercial, incluyendo
    documentos y fuentes de datos, para asegurar su legitimidad y precisión.


    Cada verificación de empresa puede incluir múltiples ítems, como Actas
    Constitutivas, Constancias de Situación Fiscal, Identificaciones Personales
    y Comprobantes de Domicilio. Trebol maneja automáticamente la clasificación
    de documentos, lo que te permite enviar todos los documentos requeridos como
    URLs descargables (por ejemplo, URLs prefirmadas de AWS o GCP).


    **Autenticación**: 

    La API utiliza una clave API para la autenticación, pasada en el encabezado
    `x-api-key`. Para obtener una clave API, por favor
    [contáctanos](mailto:sales@gotrebol.com).
  version: 1.0.0
servers:
  - url: https://api.gotrebol.com
  - url: http://{{trebol_api_base_url}}
security: []
tags:
  - name: Creacion de Verificacion
    description: Endpoints para crear nuevas verificaciones.
  - name: Leer información de la empresa
    description: >-
      Endpoints v2 para obtener información detallada de empresas y
      verificaciones.
  - name: Leer por Etiqueta
    description: >-
      Endpoints para obtener información detallada sobre empresas mediante
      etiquetas.
  - name: Leer por ID de Verificacion
    description: >-
      Endpoints para obtener información detallada sobre verificaciones mediante
      ID.
  - name: Gestión de IPs Permitidas
    description: >-
      Endpoints para gestionar la lista de IPs permitidas (whitelist) para la
      cuenta del cliente.
  - name: Gestión de API Keys
    description: Endpoints para crear, listar y eliminar API keys de la cuenta del usuario.
  - name: Gestion de item Ids
    description: Endpoints para gestionar items de verificaciones.
  - name: Invalidar un documento
    description: Endpoints para invalidar documentos de verificaciones.
  - name: Labels de Verificacion
    description: Endpoints para gestionar labels de verificaciones.
  - name: Actualizar personas clave de una verificacion
    description: Endpoints para actualizar personas clave de verificaciones.
  - name: Agregar items a una verificacion
    description: Endpoints para agregar items a verificaciones existentes.
  - name: Estado de validacion de documentos
    description: Endpoints para obtener el estado de validación de documentos.
  - name: Gestión de Flujos de Cuenta
    description: Endpoints para gestionar flujos de cuenta.
  - name: Gestión de Webhooks
    description: Endpoints para crear, listar, actualizar y eliminar webhooks de la cuenta.
  - name: Gestión de Política de Retención
    description: Endpoints para gestionar la política de retención de datos de la cuenta.
  - name: Exportación de Verificaciones
    description: >-
      Endpoints para exportar datos de verificaciones a documentos
      personalizados.
  - name: Leer información de la empresa v1
    description: >-
      Endpoints v1 (legacy) para obtener información detallada de empresas y
      verificaciones. Te recomendamos migrar a los endpoints v2.
  - name: Tipos de Ítem Personalizados
    description: >-
      Endpoints para crear y gestionar tipos de ítem personalizados con procesos
      configurables de clasificación, validación y extracción.
paths:
  /verifications/{verification-id}/sources:
    get:
      tags:
        - Leer información de la empresa v1
      summary: Obtener datos de prevalidacion de documentos
      description: >-
        Obtener fuentes para la pre-evaluación de documentos relacionados con
        una  empresa usando el id de la verificación.
      parameters:
        - in: path
          name: verification-id
          required: true
          description: El ID de la verificación.
          schema:
            type: string
      responses:
        '200':
          description: Fuentes de pre-evaluación de documentos recuperadas exitosamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanySourcesResponse'
              examples:
                Success:
                  summary: Respuesta exitosa
                  value:
                    data:
                      - type: csf_mx
                        label: Constancia SAT
                        item_id: 123
                        status: complete
                    verification:
                      id: c8dc41fc-c477-404e-aff7-b9074f86d6d1
                      tag: etiqueta
                      status: pending
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    CompanySourcesResponse:
      type: object
      properties:
        data:
          type: array
          description: Lista de fuentes internas (items) que alimentan la verificación
          items:
            $ref: '#/components/schemas/VerificationSource'
        verification:
          $ref: '#/components/schemas/VerificationSummary'
    VerificationSource:
      type: object
      properties:
        id:
          type: number
        type:
          type: string
          description: item_type
        entityName:
          type: string
          nullable: true
        documentNumber:
          type: string
          nullable: true
        documentDate:
          type: string
          nullable: true
        documentMetadata:
          type: object
          additionalProperties: true
          nullable: true
        originalFileUrl:
          type: string
          format: uri
          nullable: true
        userEventCompletedAt:
          type: string
          format: date-time
          nullable: true
        userEventName:
          type: string
          nullable: true
        invalidated:
          type: boolean
        options:
          type: object
          additionalProperties: true
          nullable: true
        fieldConfidences:
          type: object
          additionalProperties: true
          nullable: true
        validationResult:
          type: object
          additionalProperties: true
          nullable: true
        classifiedAt:
          type: string
          nullable: true
        itemValue:
          description: >-
            Solo presente para types especiales (siger, forms,
            public_sat_signatures, siger_shareholders)
          nullable: true
        itemStatus:
          type: string
        isDuplicateItem:
          type: boolean
          nullable: true
        assemblyMinute:
          type: object
          additionalProperties: true
          nullable: true
    VerificationSummary:
      type: object
      properties:
        id:
          type: string
          description: ID de la verificación.
        tag:
          type: string
          description: Etiqueta de la verificación.
        status:
          type: string
          description: Estado de la verificación.
      required:
        - id
        - tag
        - status
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Descripción breve y accionable del error
        code:
          oneOf:
            - type: string
              enum:
                - VALIDATION_ERROR
                - BAD_REQUEST
                - UNAUTHORIZED
                - FORBIDDEN
                - NOT_FOUND
                - CONFLICT
                - DUPLICATE_RESOURCE
                - INTERNAL_SERVER_ERROR
            - type: string
              description: Código de dominio específico (p.ej., items_not_provided)
          example: VALIDATION_ERROR
        timestamp:
          type: string
          format: date-time
          example: '2025-01-01T12:34:56.000Z'
  responses:
    UnauthorizedError:
      description: No autorizado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            Unauthorized:
              summary: Falta API key o inválida
              value:
                success: false
                message: Unauthorized
                code: UNAUTHORIZED
                timestamp: '2025-01-01T12:34:56.000Z'
    NotFoundError:
      description: Recurso no encontrado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            NotFound:
              summary: Recurso inexistente
              value:
                success: false
                message: Entity not found
                code: NOT_FOUND
                timestamp: '2025-01-01T12:34:56.000Z'
    InternalServerError:
      description: Error interno del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            ServerError:
              summary: Error inesperado
              value:
                success: false
                message: Internal server error
                code: INTERNAL_SERVER_ERROR
                timestamp: '2025-01-01T12:34:56.000Z'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````