​

Flujo: KYB Colombia vía API

​

Contexto

​

Endpoint base

POST https://api.gotrebol.com/verifications

​

Items disponibles para KYB CO

​

Documentos (requieren file_url)

​

Consultas públicas (no requieren archivo)

​

Globales aplicables a CO

​

Ejemplo — Consulta simple por NIT (sin documentos)

{
  "country": "co",
  "tag": "uuid-cliente-1234",
  "tax_id": "900123456-7",
  "items": [
    { "type": "rues", "options": { "nit": "900123456" } },
    { "type": "public_rut_co", "options": { "nit": "900123456" } },
    { "type": "public_address_cc_co", "options": { "nit": "900123456" } },
    { "type": "cc_co_ops", "options": { "nit": "900123456" } }
  ]
}

​

Reglas de oro para KYB CO

1. country: "co" — Colombia sí está en el enum de países soportados (["mx", "co"]). Úsalo literal.
2. NIT con o sin dígito de verificación:
   • En tax_id (a nivel verificación): puede incluir el dígito (900123456-7).
   • En options.nit de items: usualmente sin dígito (900123456).
3. cc_co_ops es dual — el mismo item funciona como consulta pública (pasando solo nit) o como documento cargable (pasando file_url). Elige según tu flujo.
4. Combina consultas públicas + documentos en la misma verificación — el ejemplo de “Combinación completa” en la doc canónica muestra el patrón realista de onboarding.
5. Para extraer estructura accionaria: usar items de tipo ubos con ubos_form_schema: "co_form" (solo aplicable en account-flows, no en verificaciones directas).

​

Fuente canónica (más detalle)

• Overview, variaciones de creación y ejemplos completos: guia-devs/uso-kyb/colombia/overview.mdx
• Items de documentos (estructura de respuesta): guia-devs/uso-kyb/colombia/items-documentos.mdx
• Items de consultas públicas (RUES, DIAN, Cámara): guia-devs/uso-kyb/colombia/items-consultas-publicas.mdx
• Reglas de validación (vr_trebol_*): guia-devs/crear-verificaciones/via-api/reglas-validacion.mdx