POST /verifications para crear verificaciones vía API. Para entender las 3 formas de procesar documentos (clasificación, validación, extracción), consulta Cómo funciona Vía API.
Para el schema técnico completo del endpoint con tipos, validaciones y ejemplos generados del OpenAPI spec, consulta API Reference — Crear una nueva verificación.
Requisitos comunes
Cuando envías documentos confile_url (aplica a todas las formas de procesamiento):
¿No tienes un
file_url? Si tus documentos están en almacenamiento privado o se generan dinámicamente, usa el flujo de carga directa, donde Trébol te proporciona una upload_url para subir el archivo directamente.Variantes del endpoint
POST /verifications acepta dos esquemas en el body, dependiendo de si usas un account-flow predefinido o envías los items directamente:
Atributos principales
Para el schema técnico completo con todos los atributos, tipos y ejemplos de request/response, consulta API Reference.
Siguiente paso: elige tu forma de procesamiento
Cada forma tiene ejemplos de payload completos y estructura de respuesta:Forma 1: Clasificación
Trébol detecta el tipo del documento (item
generic).Forma 2: Validación
Verifica tipo y reglas (item
doc_validation).Forma 3: Extracción
Extrae directamente con tipo directo.
Ejemplos de payload por caso de uso
Cada caso de uso tiene su overview con variaciones de creación y ejemplos de payload completos copy-pasteables:KYB México
Verificación de empresas mexicanas: SIGER, SAT, actas, apoderados.
KYB Colombia
Verificación de empresas colombianas: RUES, RUT, Cámara de Comercio.
KYB Estados Unidos
Verificación de empresas en EEUU: certificate of incorporation, IRS EIN, FinCEN.
KYB Todos los países
Items universales para KYB: person_id, proof_address, bank_statement, etc.
Hipotecas
Escrituras de propiedad, certificados de gravámenes, avalúos.
Nómina
Recibos de nómina y pensión.