Ir al contenido principal
tribai.co

Autenticación

Todas las llamadas requieren un token Bearer en el header Authorization. Las keys se emiten por organización y nunca expiran salvo revocación manual.

Authorization: Bearer tribai_sk_live_••••••••••••••••
POST

POST /ask

Pregunta en lenguaje natural. Ejecuta el pipeline RAG completo (rewrite → retrieve → rerank → assemble → answer) y retorna respuesta, citas y un nivel de confianza basado en evidencia.

curl -X POST https://tribai.co/api/v1/ask \
  -H "Authorization: Bearer $TRIBAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "¿Cuándo se aplica retención del 4% por servicios?",
    "page_context": "/articulo/art-392"
  }'

Response Structure (200 OK)

{
  "answer": "La retención del 4% por servicios aplica cuando...",
  "confidence_level": "high",
  "evidence_quality": 0.83,
  "sources": [
    { "id_articulo": "Art. 392", "score": 0.94, "estado": "vigente" },
    { "id_articulo": "Art. 401", "score": 0.81, "estado": "vigente" }
  ],
  "citations": [
    { "namespace": "doctrina", "numero": "Concepto DIAN 008412 de 2024", "score": 0.78 }
  ],
  "took_ms": 1480
}
GET

GET /articulo/{slug}

Devuelve el JSON enriquecido de un artículo del Estatuto Tributario: contenido vigente, modificaciones parseadas, texto derogado, normas asociadas, concordancias y referencias cruzadas.

curl https://tribai.co/api/v1/articulo/art-206 \
  -H "Authorization: Bearer $TRIBAI_API_KEY"

Response Structure (200 OK)

{
  "id_articulo": "Art. 206",
  "slug": "art-206",
  "titulo": "Rentas de trabajo exentas",
  "libro": "Libro I - Renta",
  "estado": "vigente",
  "contenido_texto": "Están gravadas con el impuesto sobre la renta...",
  "total_modificaciones": 14,
  "ultima_modificacion_year": 2022,
  "leyes_modificatorias": ["Ley 2277 de 2022", "Ley 1819 de 2016"],
  "cross_references": ["art-103", "art-388"],
  "concordancias": "..."
}
GET

GET /doctrina/{numero}

Recupera un concepto u oficio DIAN por su número. Incluye texto completo, fecha, vigencia (vigente/revocado) y artículos del ET con los que tiene concordancia.

curl https://tribai.co/api/v1/doctrina/008412-2024 \
  -H "Authorization: Bearer $TRIBAI_API_KEY"

Response Structure (200 OK)

{
  "numero": "008412",
  "year": 2024,
  "tipo": "Concepto",
  "fecha": "2024-03-15",
  "vigente": true,
  "tema": "Retención en la fuente — servicios",
  "texto": "...",
  "articulos_ET": ["art-392", "art-401"]
}
GET

GET /calendario

Lista las obligaciones del calendario tributario 2026, filtrables por dígito de NIT, mes, régimen (común/simple) o categoría (renta, IVA, ICA, retención).

curl "https://tribai.co/api/v1/calendario?nit_digit=3&month=04" \
  -H "Authorization: Bearer $TRIBAI_API_KEY"

Response Structure (200 OK)

{
  "events": [
    {
      "id": "renta-pn-04-3",
      "titulo": "Declaración de renta personas naturales",
      "categoria": "renta",
      "fecha": "2026-04-22",
      "regimen": "comun",
      "fuente": "Decreto 0094 de 2026"
    }
  ],
  "count": 1
}
GET

GET /indicadores

Constantes tributarias vigentes: UVT, SMLMV, auxilio de transporte, IPC, DTF y tasas de cambio relevantes. Incluye históricos de los últimos 5 años.

curl https://tribai.co/api/v1/indicadores \
  -H "Authorization: Bearer $TRIBAI_API_KEY"

Response Structure (200 OK)

{
  "year": 2026,
  "uvt": { "value": 52374, "currency": "COP", "norma": "Resolución DIAN 000193 de 2025" },
  "smlmv": { "value": 1750905, "currency": "COP" },
  "auxilio_transporte": { "value": 249095, "norma": "Decreto 1470 de 2025" },
  "ipc_anual": 0.0428
}
POST

POST /retencion/calcular

Calcula la retención en la fuente para un concepto y una base gravable. Devuelve la tarifa aplicable, el valor retenido, la base mínima en UVT y la fundamentación normativa.

curl -X POST https://tribai.co/api/v1/retencion/calcular \
  -H "Authorization: Bearer $TRIBAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "concepto": "servicios_generales", "base": 5000000 }'

Response Structure (200 OK)

{
  "concepto": "servicios_generales",
  "base": 5000000,
  "tarifa": 0.04,
  "valor_retenido": 200000,
  "base_minima_uvt": 4,
  "base_minima_cop": 209496,
  "norma": "Art. 392 ET — Decreto 0260 de 2001"
}

Servidor MCP

Conecta Tribai como herramienta a Claude Desktop, Cursor, Codex y cualquier cliente MCP. Mismo API key que el REST. Transport: Streamable HTTP. Endpoint: https://mcp.tribai.co/v1.

Tools disponibles

tribai.search— Búsqueda semántica multi-namespace
tribai.ask— RAG con citas y nivel de confianza
tribai.articulo— Fetch artículo del ET por slug
tribai.doctrina— Concepto u oficio DIAN por número
tribai.calendario— Obligaciones por NIT, mes o régimen
tribai.indicadores— UVT, SMLMV, auxilio vigentes
tribai.calcular_retencion— Concepto + base → retención

Claude Desktop / Code

{
  "mcpServers": {
    "tribai": {
      "url": "https://mcp.tribai.co/v1",
      "headers": { "Authorization": "Bearer ${TRIBAI_API_KEY}" }
    }
  }
}

Cursor / Codex

{
  "mcp": {
    "tribai": {
      "transport": "http",
      "url": "https://mcp.tribai.co/v1",
      "headers": { "Authorization": "Bearer ${TRIBAI_API_KEY}" }
    }
  }
}

Rate limits y planes

PlanRequests/minRequests/mesMCPSoporte
Free101.000—Comunidad
Profesional120100.000SíEmail 48h
EnterpriseCustomCustomDedicadoSLA + Slack

Errores 429 incluyen el header Retry-After en segundos.