> ## 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 un item de verificación por ID > Retorna un item de verificación específico por su ID. **Coordenadas de citas:** para items de tipo acta, agrega `?with_citations=true` y la respuesta incluirá `citations.url` con la URL firmada al artifact de coordenadas de ese documento. Ver [Coordenadas de citas](/guia-devs/referencia/coordenadas-citas). ## OpenAPI ````yaml /api-reference/openapi.yaml get /verification-items/{id} 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. - name: Síntesis de Dictamen description: >- Endpoints para ejecutar bajo demanda la Síntesis de Dictamen (`findings`) de una verificación. paths: /verification-items/{id}: get: tags: - Gestion de item Ids summary: Obtener un item de verificación por ID description: > Retorna un item de verificación específico por su ID. **Coordenadas de citas:** para items de tipo acta, agrega `?with_citations=true` y la respuesta incluirá `citations.url` con la URL firmada al artifact de coordenadas de ese documento. Ver [Coordenadas de citas](/guia-devs/referencia/coordenadas-citas). parameters: - name: id in: path required: true description: El ID único del item de verificación schema: type: string - name: with_citations in: query required: false description: > Solo aplica a items de tipo acta. Si es `true`, la respuesta incluye `citations.url`: una URL firmada al artifact de coordenadas de ese documento. Ver [Coordenadas de citas](/guia-devs/referencia/coordenadas-citas). schema: type: boolean default: false responses: '200': description: Item de verificación obtenido exitosamente content: application/json: schema: $ref: '#/components/schemas/PublicVerificationItem' examples: Success: summary: Item de verificación obtenido exitosamente value: id: 26600 item_order: 3 item_status: complete item_type: ac_mx item_internal_status: classification_failed item_value: value: itemCustomed user_event_completed_at: '2025-09-23T03:30:32Z' user_event_name: add_item user_event_reason: item created without a file_url tag: null item_scope: advanced tags: uploaded-from: webapp-creation-business original_file_url: >- https://files.staging.gotrebol.com/66b4b55e-0e4f-42ec-9727-2bff88965562/26600_original_file.pdf?response-content-type=application%2Fpdf&response-content-disposition=inline&Expires=1758902113&Key-Pair-Id=K2O2X5EIJK95L0&Signature=X0if4WzR23I0s61h~gW2s-92nGNXhQBHZp9bxl42HqMSMO1VYpybLmhtygyJfx5OvZL4NSoYHTYfH7-yZv02lRwtNSI~xYFAVVxPPFROzwblK66LwymsQWAE0xvwtI98eWQKBWop3rgHADqrUGIm1RBa2qm3Ydlj2HVtWmsrVn2OTMtnIuoyI50Z8iYmx6hcPLul6SazK4h18MMRRi5xnsa2shrGs36rLyRFlnDBObRFJBKmkH4Dn27PuCVrXQRHQwRUIyRCQAiLGSuVKDp~iWZqTld6qgDQOkq-0A54dv0r8O6hYZ5fPyX1ufeIJeaKaGKjKC9qAiOWl~wQe6-w9g__ CustomItemType: summary: Item de un tipo de ítem personalizado (cit_*) value: id: 31544 item_order: 1 item_status: complete item_type: cit_contrato_arrendamiento item_internal_status: extraction_finished item_error: null item_value: current_stage: extraction pipeline: validation: - process_reference: validar_firmas executed: true execution_result: true value: identifier: activeVersionId_87 validation_result: true explanation: El contrato está firmado por ambas partes. extraction: - process_reference: extraer_datos_contrato executed: true execution_result: success value: landlord_name: María López García tenant_name: Carlos Ramírez Soto monthly_rent: 15000 start_date: '2026-02-01' contract_duration: 12 meses original_file_url: >- https://files.gotrebol.com/66b4b55e-0e4f-42ec-9727-2bff88965562/31544_original_file.pdf RfcDePruebaSatNoEncontrado: summary: 'RFC de prueba B: SAT no encuentra el RFC' description: > Escenario B (`TRB010101NF1`). La consulta corrió bien y el SAT no tiene el RFC: es un resultado definitivo. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34173 item_order: 15 item_status: complete item_type: public_sat_signatures item_internal_status: screenshot_taken item_value: tax_ids: - TRB010101NF1 data: TRB010101NF1: status: fail tax_id_number: TRB010101NF1 legal_name: '' business_type: '' certificates: [] validation_result: success: false reason: rfc_not_found validated_at: '2026-09-10T12:00:30.000Z' scraped_at: '2026-09-10T12:00:30.000Z' screenshot_at: '2026-09-10 12:00:31' screenshot_url: >- https://files.gotrebol.com/mx/sat/screenshots/900016/TRB010101NF1/demo.jpg tag: null item_scope: advanced tags: {} RfcDePruebaSatFallaTecnica: summary: 'RFC de prueba C: falla técnica del SAT' description: > Escenario C (`TRB010101ER1`). La consulta al SAT falló por un problema técnico: vale la pena crear el ítem de nuevo. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34188 item_order: 15 item_status: complete item_type: public_sat_signatures item_internal_status: sat_scrap_failed item_value: tax_ids: - TRB010101ER1 data: TRB010101ER1: status: fail tax_id_number: TRB010101ER1 legal_name: '' business_type: '' certificates: [] validation_result: success: false reason: scraper_error validated_at: '2026-09-10T12:00:30.000Z' scraped_at: '2026-09-10T12:00:30.000Z' screenshot_at: '2026-09-10 12:00:31' screenshot_url: >- https://files.gotrebol.com/mx/sat/screenshots/900016/TRB010101ER1/demo.jpg tag: null item_scope: advanced tags: {} RfcDePruebaSigerNoEncontrado: summary: 'RFC de prueba B: SIGER no encuentra la empresa' description: > Escenario B (`TRB010101NF1`). Resultado definitivo. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34172 item_order: 14 item_status: complete item_type: siger item_internal_status: siger_not_found item_value: {} tag: null item_scope: advanced tags: {} RfcDePruebaSigerFalla: summary: 'RFC de prueba C: falla de SIGER' description: > Escenario C (`TRB010101ER1`). La consulta a SIGER no pudo completarse. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34187 item_order: 14 item_status: complete item_type: siger item_internal_status: siger_not_found_ops_forced item_value: {} tag: null item_scope: advanced tags: {} RfcDePruebaDocumentoIlegible: summary: 'RFC de prueba C: documento que no se pudo leer' description: > Escenario C (`TRB010101ER1`). `item_status` sigue en `complete`: el fallo se lee en `item_error`. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34170 item_order: 0 item_status: complete item_type: ac_mx item_internal_status: null item_error: get_input_file_info_failed item_value: {} tag: null item_scope: advanced tags: {} RfcDePruebaReglaNoCumplida: summary: 'RFC de prueba D: documento que no cumple su regla' description: > Escenario D (`TRB010101DV1`). El tipo es correcto pero la regla no se cumple. No hay `item_error`: el motivo se lee en `rules_validation_result`. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34201 item_order: 0 item_status: complete item_type: doc_validation item_internal_status: validation_failed item_value: rules_validation_result: - id: vr_trebol_antiguedad variable_value: '2026-01-10' validation_result: false item_type_validation_result: - validation_result: true reason: >- The document is a "Constancia de Situación Fiscal" issued by the "SERVICIO DE ADMINISTRACIÓN TRIBUTARIA" for a persona moral, with the RFC, "idCIF", tax regime, fiscal address and a QR code, which are all strong indicators of a CSF. tag: null item_scope: advanced tags: {} RfcDePruebaTipoIncorrecto: summary: 'RFC de prueba D: documento de otro tipo' description: > Escenario D (`TRB010101DV1`). Se esperaba un estado de cuenta y llegó un recibo de CFE: falla la validación del tipo aunque la regla se cumpla. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34204 item_order: 3 item_status: complete item_type: doc_validation item_internal_status: validation_failed item_value: rules_validation_result: - id: vr_trebol_antiguedad variable_value: '2026-08-05' validation_result: true item_type_validation_result: - validation_result: false reason: >- The document is a CFE electricity bill ("Comisión Federal de Electricidad") for "COMERCIALIZADORA TRÉBOL DEMO, S.A. DE C.V.", with the service number, billing period, consumption history and amount due. It is a proof of address, not a bank statement: it has no bank name, CLABE, account number or transaction detail. tag: null item_scope: advanced tags: {} RfcDePruebaSatRepresentante: summary: 'RFC de prueba E: SAT del representante legal' description: > Escenario E (`TRB010101RF1`). El item `representatives` consulta el RFC que nombran los certificados de la empresa en `legalRepresentativeRFC`, no el de la empresa. Ver [RFC de prueba](/guia-devs/pruebas/rfc-de-prueba). value: id: 34211 item_order: 1 item_status: complete item_type: public_sat_signatures item_internal_status: screenshot_taken item_value: tax_ids: - RUTD800515AB2 data: RUTD800515AB2: status: success tax_id_number: RUTD800515AB2 legal_name: DIEGO ALBERTO RUIZ TORRES business_type: '' certificates: - numeroSerie: '00001000000700912351' estado: Activo tipo: FIEL fechaInicial: '2026-04-06T19:05:09.000Z' fechaFinal: '2030-04-06T19:05:49.000Z' personEmail: firmante@demo.mx serieLink: >- https://rdc.sat.gob.mx/rccf/000010/000007/00/91/23/00001000000700912351.cer - numeroSerie: '00001000000500912352' estado: Revocado tipo: FIEL fechaInicial: '2022-05-04T16:52:10.000Z' fechaFinal: '2026-04-06T19:05:09.000Z' serieLink: >- https://rdc.sat.gob.mx/rccf/000010/000005/00/91/23/00001000000500912352.cer validated_at: '2026-09-28T16:35:18.497Z' scraped_at: '2026-09-28T16:35:18.497Z' screenshot_at: '2026-09-28 16:35:27' screenshot_url: >- https://files.gotrebol.com/mx/sat/screenshots/900202/RUTD800515AB2/demo.jpg tag: null item_scope: advanced tags: {} '401': $ref: '#/components/responses/UnauthorizedError' '404': $ref: '#/components/responses/NotFoundError' '500': $ref: '#/components/responses/InternalServerError' security: - ApiKeyAuth: [] components: schemas: PublicVerificationItem: type: object properties: id: type: number item_status: type: string item_order: type: number item_type: type: string item_value: description: > Estructura depende de `item_type`. Ver guía en /guia-devs/respuestas-por-tipo-de-item. Además de los campos propios del tipo, incluye una llave `cp_` por cada extracción personalizada con resultado para ese ítem, donde `prompt_id` es el identificador editable de la extracción. Ver [Extracciones personalizadas](/producto/guias/extracciones-personalizadas). Ese prefijo solo aplica a tipos de documento estándar. Un ítem de un tipo de ítem personalizado (`item_type` con prefijo `cit_`) nunca lleva llaves `cp_`: sus resultados viven en `pipeline`, con la forma del schema `CustomItemTypeItemValue`. Ver [Tipos de ítem personalizados](/producto/guias/tipos-de-item-personalizados#donde-salen-los-resultados). type: object additionalProperties: true item_error: type: string nullable: true description: > Campo opcional que indica errores públicos relacionados con el procesamiento del ítem. Su valor depende del `item_type` que produjo el error. **Comunes a ítems documentales** - `password_protected_pdf`: el PDF está protegido con contraseña y no se envió `file_password`. Reenvía el archivo con `options.file_password`. - `invalid_file_password`: se envió `file_password` pero el PDF la rechazó. Reenvía el archivo con la contraseña correcta. - `get_input_file_info_failed`: falló la obtención de información del archivo de entrada. **Específicos de `doc_splitter`** (ver [guía](/producto/guias/doc-splitter) para el listado completo) - `unsupported_file_type`: el archivo no es un PDF. - `unknown_custom_item_type` / `misconfigured_custom_item_type`: `allowed_item_types` o `client_item_type` referencia un tipo personalizado (`cit_*`) que no existe o no está listo. - `no_splits_returned`: el análisis no identificó ningún documento en el PDF. - `pdf_slice_failed`: no se pudo leer o recortar el PDF (archivo corrupto o error de descarga del original). - `pdf_slice_upload_failed`: se recortaron los sub-PDFs pero falló la subida de al menos uno. - `doc_splitter_request_failed`: falló la llamada al servicio de análisis (OCR o AI). Reintentar suele resolverlo. **Específicos de `doc_validation`** - `invalid_document_type`: el documento no corresponde al `client_item_type` esperado. - `ruleset_validation_failed`: al menos una regla del `ruleset` no se cumplió. Trata este campo como un `string` opaco: además de los códigos anteriores puede llegar con otros valores para ítems específicos (por ejemplo `prevalidation_failed` en `csf_mx`) o, en errores inesperados, con un mensaje libre en inglés. item_internal_status: type: string nullable: true item_options: type: object additionalProperties: true nullable: true properties: upload_url: type: string format: uri description: >- URL firmada temporal para subir el archivo del item mediante PUT. Después de subirlo, confirma con options.uploaded_file en PUT /verification-items/{id}. item_ui_options: type: object additionalProperties: true nullable: true validation_result: type: object additionalProperties: true nullable: true user_event_completed_at: type: string nullable: true user_event_name: type: string nullable: true user_event_reason: type: string nullable: true tag: type: string nullable: true item_scope: type: string nullable: true original_file_url: type: string nullable: true citations: type: object description: > Presente solo cuando se llamó con `?with_citations=true` y el item es de tipo acta. Contiene la URL firmada (CloudFront) al artifact de coordenadas en S3. Ver [Coordenadas de citas](/guia-devs/referencia/coordenadas-citas). properties: url: type: string format: uri description: > URL firmada y temporal. Descarga el JSON cuanto antes; si caduca, vuelve a llamar al endpoint con el flag para obtener una nueva. Si el artifact aún no se horneó para esta verificación, no se devuelve la llave citations. example: >- https://files.gotrebol.com/{verification_id}/citations/sources/{item_id}.json?Expires=…&Signature=… required: - url 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 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.