Las consultas a fuentes oficiales que un abogado hace en su panel, para llamarlas desde el sistema de un despacho. Hoy son 21 consultas a 9 entidades. Cada llamada sale en vivo a la fuente, devuelve el dato con el enlace oficial de donde salió y gasta créditos sólo si la fuente respondió.
La lista de consultas, con el esquema de entrada de cada una, también se puede pedir por la propia API, sin llave: GET https://www.kippilex.co/api/v1. La ficha de una sola, en GET /api/v1/nombre_de_la_consulta.
La llave
Toda consulta lleva la cabecera Authorization: Bearer klx_TU_LLAVE. La llave no se acepta en la dirección ni en el cuerpo. Según su plan, una cuenta puede tener entre 1 y 5 llaves activas, por ejemplo una por sistema, y cada una se revoca desde el panel sin afectar a las demás.
KippiLex guarda sólo una huella de la llave, no la llave: por eso no puede volver a mostrarla. Si se pierde o se filtra, se revoca y se crea otra. La API se llama desde un servidor; una llave puesta en el código de una página web queda publicada.
Créditos
Una consulta cuesta 1 crédito; las que le hacen varias peticiones a la fuente cuestan hasta 2, y cada una lo dice en su ficha. Se cobra sólo cuando la fuente respondió: una entrada mal escrita, una fuente caída o un «no existe» no gastan nada. Cada respuesta dice cuántos créditos usó y cuántos quedan.
Sin saldo suficiente, la API responde con el estado 402 y no consulta la fuente. El saldo también se puede pedir sin gastar: GET /api/v1/saldo, con la llave.
Límites
30 peticiones por minuto por cuenta, sumando todas sus llaves. Al pasarse, estado 429 y la cabecera Retry-After con los segundos que hay que esperar.
Cada consulta tiene 45 segundos para responder. Si la fuente tarda más, llega un error de tiempo y no se cobra.
El cuerpo de la petición es un objeto JSON de hasta 8.000 bytes.
Ninguna consulta busca por el nombre de una persona natural. Las de empresa aceptan sólo el NIT de una persona jurídica.
Respuestas y errores
Una respuesta buena llega con el estado 200 y cuatro campos: datos, fuente_oficial_url, creditos_usados y creditos_restantes.
Un error llega con su estado y un objeto error con un codigo estable, un mensaje para leer y, cuando se sabe, la dirección oficial para hacer la consulta a mano. Una fuente que falla nunca se entrega como una lista vacía.
{
"error": {
"codigo": "tiempo",
"mensaje": "La fuente no respondió dentro del tiempo disponible. Intenta de nuevo en unos minutos.",
"fuente_oficial_url": "https://consultaprovidencias.cortesuprema.gov.co/busqueda"
},
"creditos_usados": 0,
"creditos_restantes": 100
}
entrada· estado 400
La entrada no cumple el esquema de la consulta. El mensaje dice qué campo corregir.
persona· estado 400
La consulta es el nombre de una persona. No se hace.
no_existe· estado 404
La fuente respondió que eso no existe.
sin_texto· estado 502
El documento existe, pero la fuente no entregó su texto.
antirobot· estado 502
La fuente puso un captcha o un bloqueo. KippiLex no los evade.
tiempo· estado 504
La fuente no respondió dentro del tiempo disponible.
fuente· estado 502
La fuente falló, cambió de forma o no hubo red.
sin_llave· estado 401
Falta la cabecera Authorization con la llave.
llave_invalida· estado 401
La llave no existe o no tiene la forma de una llave de KippiLex.
llave_revocada· estado 401
La llave fue revocada desde el panel.
sin_saldo· estado 402
El saldo no alcanza para esta consulta.
consulta_desconocida· estado 404
No existe una consulta con ese nombre.
consulta_no_ofrecida· estado 403
La consulta existe en KippiLex, pero no se ofrece por la API.
cuerpo_invalido· estado 400
El cuerpo de la petición no es un objeto JSON.
demasiadas_peticiones· estado 429
Se superó el tope de peticiones por minuto. La cabecera Retry-After dice cuánto esperar.
metodo· estado 405
Ese método no existe en esta dirección.
servicio· estado 503
KippiLex no pudo comprobar la llave o el saldo. No se consultó la fuente ni se cobró.
Qué se guarda de cada llamada
KippiLex no guarda lo que responden las fuentes: cada consulta es en vivo. De cada llamada anota la consulta, la fecha, el resultado y los créditos, que es lo que el abogado ve en su consumo. La entrada sólo se anota cuando no identifica a nadie: si trae una placa, un NIT, un radicado o un número de documento, no se guarda.
Conectar por MCP
Las mismas consultas se pueden conectar a un asistente de IA que acepte servidores MCP por HTTP: cada consulta de esta página aparece como una herramienta, con el mismo nombre y la misma entrada. La dirección es https://www.kippilex.co/api/mcp y la llave va en la misma cabecera Authorization. En los asistentes que leen un archivo de servidores, la entrada tiene esta forma; dónde va ese archivo lo dice cada asistente.
La llave se comprueba al conectar. Cada consulta que responde gasta los mismos créditos que por la API y queda en el mismo consumo; cada llamada a una herramienta cuenta en el mismo tope de la cuenta. Conectar y pedir la lista de herramientas no lo gastan. Cuando una fuente falla, el asistente recibe el error con su motivo y el enlace oficial, no una lista vacía. La herramienta kippilex_saldo dice el saldo sin gastar créditos. Ese archivo guarda tu llave: no lo compartas ni lo subas a un repositorio.
Para probar la conexión sin un asistente, pide la lista de herramientas:
Buscar providencias de la Corte Suprema de Justicia
Corte Suprema de Justicia · 1 crédito por consulta que responde
POST /api/v1/corte_suprema_buscar
Busca en el texto completo de las sentencias y autos de la Corte Suprema de Justicia, sala por sala: civil, laboral, penal o tutelas. Úsala para casación y jurisprudencia de la jurisdicción ordinaria. Hay que decir la sala, salvo que se busque un número de providencia que ya la dice («SC3280-2024», «SL1234-2023», «SP456-2022», «STC789-2021»). Exige todas las palabras; entre comillas busca la frase exacta. Devuelve fichas con número, radicado, ponente, fragmentos y enlace oficial; el total cuenta por separado las copias en Word y PDF. Para el texto usa «corte_suprema_leer» con el «id» de la ficha. No busca por nombre de persona.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://consultaprovidencias.cortesuprema.gov.co/busqueda",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Leer una providencia de la Corte Suprema de Justicia
Corte Suprema de Justicia · 1 crédito por consulta que responde
POST /api/v1/corte_suprema_leer
Trae la ficha y el texto de una providencia de la Corte Suprema a partir del «id» que devolvió «corte_suprema_buscar». Úsala para leer o citar una sentencia o un auto ya encontrado. El texto llega por tramos: si «hay_mas» es verdadero, repite la llamada con «desde» igual a «siguiente_desde». Los números de documento de identidad van tapados.
El «id» de la providencia, tal como lo devolvió «corte_suprema_buscar». De 8 a 700 caracteres.
desde· número entero · opcional
Posición del primer carácter del tramo de texto que se quiere. 0 para empezar; para seguir, el «siguiente_desde» de la respuesta anterior. Entre 0 y 20000000.
maximo· número entero · opcional
Cuántos caracteres de texto traer en esta llamada. Por defecto 30000; como mucho 60000. Entre 1000 y 60000.
El id del ejemplo muestra la forma; usa el que te devolvió corte_suprema_buscar.
Ejemplo de respuesta
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://consultaprovidencias.cortesuprema.gov.co/busqueda",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Buscar providencias del Consejo de Estado
Consejo de Estado · 2 créditos por consulta que responde
POST /api/v1/consejo_de_estado_buscar
Busca en la relatoría tradicional del Consejo de Estado por tema, por palabras del texto, por número de proceso, por norma que sustenta la decisión o por norma demandada, con filtros de sección, tipo y fechas. Úsala para lo contencioso administrativo: nulidad, reparación directa, contratos estatales, asuntos electorales y conceptos de la Sala de Consulta. Hace falta al menos un criterio de texto o el número de proceso. La fuente entrega una ficha por petición, así que es lenta: pide pocas («cuantas») y sólo llega hasta la ficha 60 de cada búsqueda. Las providencias posteriores a diciembre de 2021 pueden venir sin texto: están en «Mi Relatoría» de SAMAI, cuyo enlace va en la respuesta. No busca por nombre de persona ni devuelve a las partes.
Cuesta 2 créditos: La relatoría entrega las fichas de una en una: cada resultado es una petición más a la fuente.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://jurisprudencia.ramajudicial.gov.co/WebRelatoria/ce/index.xhtml",
"creditos_usados": 2,
"creditos_restantes": 98
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Leer el texto de una providencia del Consejo de Estado
Consejo de Estado · 1 crédito por consulta que responde
POST /api/v1/consejo_de_estado_leer
Trae el texto de una providencia del Consejo de Estado a partir del «nr» que devolvió «consejo_de_estado_buscar». El texto llega por tramos: si «hay_mas» es verdadero, repite la llamada con «desde» igual a «siguiente_desde». Si la relatoría no tiene el texto (pasa con providencias posteriores a 2021), lo dice y da el enlace a SAMAI; no inventa nada. Los números de documento de identidad van tapados.
Número de registro (NR) de la providencia, tal como lo devolvió «consejo_de_estado_buscar».
desde· número entero · opcional
Posición del primer carácter del tramo de texto que se quiere. 0 para empezar; para seguir, el «siguiente_desde» de la respuesta anterior. Entre 0 y 20000000.
maximo· número entero · opcional
Cuántos caracteres de texto traer en esta llamada. Por defecto 30000; como mucho 60000. Entre 1000 y 60000.
El nr del ejemplo muestra la forma; usa el que te devolvió consejo_de_estado_buscar.
Ejemplo de respuesta
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://jurisprudencia.ramajudicial.gov.co/WebRelatoria/ce/index.xhtml",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Confecámaras — RUES · 1 crédito por consulta que responde
POST /api/v1/empresa_registro_mercantil
Dice si una empresa existe en el registro mercantil y cómo está: razón social, matrícula y su estado, cámara de comercio, organización jurídica, último año renovado, actividad económica, representante legal publicado y cuántos establecimientos tiene. Úsala para comprobar la existencia y el estado de una sociedad antes de contratar o demandar. Es el extracto abierto del RUES en datos.gov.co, no el certificado de existencia y representación legal. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/c82u-588k",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Estados financieros de una sociedad (Supersociedades)
Superintendencia de Sociedades · 1 crédito por consulta que responde
POST /api/v1/empresa_estados_financieros
Trae las cifras principales de los estados financieros que la sociedad reportó a la Superintendencia de Sociedades en sus últimos cortes: situación financiera, resultados, flujo de efectivo y otro resultado integral. Úsala para valorar la solvencia de una contraparte. Si el NIT no aparece, significa que no reporta a Supersociedades (por ejemplo, un banco o un emisor vigilado por la Superfinanciera), no que la empresa no exista. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/pfdp-zks5",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Carátula del último reporte financiero de una sociedad (Supersociedades)
Superintendencia de Sociedades · 1 crédito por consulta que responde
POST /api/v1/empresa_caratula_financiera
Trae la carátula del último reporte NIIF de la sociedad ante la Superintendencia de Sociedades: razón social, estado que la propia sociedad declaró, tipo societario, domicilio, fecha de constitución, concepto del revisor fiscal y fecha de corte. Úsala para saber si la sociedad reporta y hasta qué ejercicio. Para las cifras usa «empresa_estados_financieros». Que el NIT no aparezca sólo significa que no reporta a Supersociedades. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/6hqw-m3dm",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Quejas contra una entidad financiera (Superfinanciera)
Superintendencia Financiera de Colombia · 1 crédito por consulta que responde
POST /api/v1/empresa_quejas_financieras
Para un banco, aseguradora u otra entidad vigilada por la Superintendencia Financiera: cuántas quejas ha recibido mes a mes y, en los últimos 24 meses, por qué productos y por qué motivos. Úsala para sustentar una reclamación de consumidor financiero o conocer el historial de quejas de la entidad. Si el NIT no es de una entidad vigilada, lo dice. Son conteos: no trae quejas individuales ni datos de quien se quejó. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/xyy7-rn7p",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Contratos de una empresa con el Estado (SECOP)
Colombia Compra Eficiente — SECOP · 1 crédito por consulta que responde
POST /api/v1/empresa_contratos_con_el_estado
Cuenta los contratos que la empresa ha firmado como contratista con entidades públicas en SECOP I y SECOP II, da la fecha del último y lista los cinco más recientes con entidad, objeto de contratación, valor, estado y enlace al proceso. Úsala para saber si una empresa contrata con el Estado y con quién. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/jbjy-vk9h",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Procesos de contratación de una empresa (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/empresa_procesos_de_contratacion
Procesos de contratación de SECOP II en los que la empresa aparece como proveedor adjudicado, con los cinco más recientes; y, si el NIT es de una entidad compradora, los procesos que ha publicado. Úsala para revisar adjudicaciones recientes de una empresa o la actividad de compra de una entidad. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/p6dx-8zbt",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Procesos en los que una empresa presentó oferta (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/empresa_ofertas_en_secop
Cuenta los procesos de SECOP II en los que la empresa figura como proponente y lista los cinco más recientes con la entidad compradora. Úsala para saber en qué licitaciones participó una empresa, aunque no las haya ganado. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/hgi6-6wh3",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Registro de una empresa como proveedor del Estado (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/empresa_registro_de_proveedor
Dice si la empresa está inscrita como proveedor en SECOP II y con qué datos: fecha de inscripción, si está activa, tipo y tamaño de empresa, categoría principal, municipio y representante legal declarado. Úsala para comprobar si una empresa puede contratar por SECOP II. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/qmzu-gj57",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Adiciones y modificaciones a los contratos de una empresa (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/empresa_adiciones_de_contratos
Revisa los contratos más recientes de la empresa en SECOP II y lista las adiciones y modificaciones registradas sobre ellos (tipo, descripción y fecha). Úsala para ver si los contratos de una empresa se han adicionado o prorrogado. Sólo mira los contratos más recientes, y lo dice. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/cb9c-h8sn",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Multas y sanciones contractuales de una empresa (SECOP I y II)
Colombia Compra Eficiente — SECOP · 2 créditos por consulta que responde
POST /api/v1/empresa_multas_y_sanciones_secop
Lista las multas, sanciones e incumplimientos que las entidades públicas le han registrado a la empresa como contratista en SECOP I y SECOP II: entidad, acto, contrato, valor, fecha y estado. Úsala para saber si un contratista ha sido multado o declarado incumplido. SECOP II no trae NIT: se cruza por el código de proveedor de ese NIT y, si no lo tiene, lo dice en vez de buscar por nombre. Es un dato sancionatorio que hay que confirmar en el SECOP; «sin multas» significa que no hay registros en esos dos conjuntos, no un paz y salvo. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
Cuesta 2 créditos: Cruza dos conjuntos del SECOP: primero el código de proveedor de la empresa y después sus multas y sanciones.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/4n4q-k399",
"creditos_usados": 2,
"creditos_restantes": 98
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Sanciones de la SIC a una empresa por protección al consumidor
Superintendencia de Industria y Comercio · 2 créditos por consulta que responde
POST /api/v1/empresa_sanciones_sic
Lista las sanciones en firme que la Superintendencia de Industria y Comercio le ha impuesto a la empresa por protección al consumidor: resolución, fecha, valor, conducta y sector. Úsala para saber si una empresa ha sido multada por publicidad engañosa, garantías o calidad. El listado no trae NIT: se toma la razón social del RUES y sólo se muestran los multados con ese nombre exacto, así que puede haber una sociedad homónima y hay que verificar con la resolución. NO incluye sanciones de competencia, datos personales, metrología ni propiedad industrial, y no encuentra a la empresa si la SIC la registró con otro nombre. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
Cuesta 2 créditos: Lee primero la razón social en el RUES y después busca las sanciones en el conjunto de la SIC.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/73dx-n59j",
"creditos_usados": 2,
"creditos_restantes": 98
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Posición de una empresa entre las 10.000 más grandes del país
Superintendencia de Sociedades · 1 crédito por consulta que responde
POST /api/v1/empresa_entre_las_mas_grandes
Dice si la empresa figura en el reporte de las 10.000 empresas más grandes de Colombia y, por cada año de corte, sus ingresos operacionales, ganancia o pérdida, activos, pasivos y patrimonio, con su sector, ciudad y la superintendencia que la supervisa. Úsala para dimensionar a una contraparte de un vistazo. Las cifras vienen en billones de pesos, como las publica la fuente. Que no aparezca sólo significa que no entró en esa lista; para los estados financieros completos usa «empresa_estados_financieros». Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/6cat-2gcs",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Grado de supervisión de una sociedad ante Supersociedades
Superintendencia de Sociedades · 1 crédito por consulta que responde
POST /api/v1/empresa_supervision_supersociedades
Dice si la sociedad figura en la lista de sujetos obligados de la Superintendencia de Sociedades y en qué grado de supervisión está (inspección, vigilancia o control), por cada fecha de corte publicada, con su ciudad. Úsala para saber si una sociedad está vigilada o controlada por Supersociedades. El grado de supervisión no es una sanción. La lista se actualiza pocas veces al año; que no aparezca sólo significa que no figura como supervisada por esa entidad (puede estarlo por otra superintendencia). No trae procesos de insolvencia. Sólo para empresas identificadas por NIT: no sirve para consultar a una persona natural, ni por nombre ni por cédula.
NIT de la empresa (persona jurídica): nueve cifras que empiezan por 8 o por 9, con o sin puntos y con o sin dígito de verificación. Ejemplos: 899999068, 899.999.068-1. No admite cédulas ni NIT de personas naturales. De 9 a 20 caracteres.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/dd55-74ss",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Buscar procesos de contratación pública por su objeto (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/secop_buscar_procesos
Busca procesos de contratación de SECOP II cuyo objeto contenga las palabras dadas, del más reciente al más antiguo: entidad compradora, objeto, modalidad, estado, precio base, valor adjudicado, fechas y enlace al proceso. Úsala para encontrar licitaciones o contratos sobre un tema («interventoría puente vehicular», «suministro de alimentación escolar») o para ver qué está contratando una entidad, dando su NIT. Devuelve 20 por página y no cuenta el total. Sólo SECOP II (no SECOP I ni la Tienda Virtual). Busca en el objeto del proceso, NO por proveedor ni por nombre de persona: para los procesos de una empresa usa «empresa_procesos_de_contratacion» con su NIT. No muestra al adjudicatario; ese dato está en la ficha.
Palabras del objeto del proceso, sin importar tildes. Deben estar todas. Ejemplos: «interventoría puente vehicular», «vigilancia privada». No admite nombres de personas. De 3 a 120 caracteres.
nit_entidad· texto · opcional
NIT de la entidad pública compradora, para limitar la búsqueda a sus procesos: nueve cifras que empiezan por 8 o por 9, con o sin dígito de verificación. Ejemplo: 899999090. No es el NIT del contratista. De 9 a 20 caracteres.
pagina· número entero · opcional
Página de resultados, desde 1 y hasta 25. Sin ella, la primera. Entre 1 y 25.
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/p6dx-8zbt",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Ficha de un proceso de contratación por su identificador (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/secop_proceso_por_identificador
Trae la ficha de un proceso de SECOP II a partir de su identificador: entidad, objeto y descripción, modalidad y su justificación, estado y fase, precio base, duración, fechas de publicación y de ofertas, cuántas ofertas recibió, la adjudicación (valor, fecha y adjudicatario si es una empresa) y los contratos firmados dentro del proceso. Úsala cuando ya tienes el identificador, por ejemplo de «secop_buscar_procesos» o de un enlace del SECOP. No sirve para buscar por tema ni por empresa. No muestra el nombre del funcionario que adjudicó ni el de contratistas personas naturales: remite al enlace oficial.
Identificador del proceso en SECOP II: CO1.REQ.1234567 (proceso), CO1.BDOS.1234567 (expediente) o CO1.NTC.1234567 (el «noticeUID» del enlace público). También se puede pegar el enlace público del proceso. De 9 a 300 caracteres.
El identificador del ejemplo muestra la forma; usa el de un proceso real del SECOP II.
Ejemplo de respuesta
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/p6dx-8zbt",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Ficha de un contrato estatal por su identificador (SECOP II)
Colombia Compra Eficiente — SECOP II · 1 crédito por consulta que responde
POST /api/v1/secop_contrato_por_identificador
Trae la ficha de un contrato electrónico de SECOP II a partir de su identificador (CO1.PCCNTR.1234567): entidad, objeto, tipo y modalidad, estado, fechas de firma y de fin, duración, valor del contrato y lo pagado, facturado y pendiente, origen de los recursos, el contratista si es una empresa, y las adiciones y modificaciones registradas. Úsala cuando ya tienes el identificador del contrato, por ejemplo de la ficha del proceso o de las consultas de contratos de una empresa. No sirve para buscar contratos por tema ni por contratista. No muestra al contratista persona natural, al representante legal, al supervisor ni datos bancarios.
El identificador del ejemplo muestra la forma; usa el de un contrato real del SECOP II.
Ejemplo de respuesta
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/jbjy-vk9h",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Historial de multas de tránsito de un vehículo, por placa (SIMIT abierto)
Federación Colombiana de Municipios — SIMIT · 1 crédito por consulta que responde
POST /api/v1/multas_de_transito_por_placa
Lista las multas de tránsito registradas a una placa en el historial abierto del SIMIT, de 2019 a 2025: fecha, valor, ciudad y si figuraba pagada. Úsala para revisar el historial de un vehículo, por ejemplo antes de una compraventa. NO es el estado de cuenta de hoy ni un paz y salvo: es una copia anual con corte al 31 de diciembre de 2025. La placa identifica al vehículo, no a quien conducía ni a su dueño actual; no trae nombres, cédulas ni números de comparendo. Sólo recibe la placa.
La placa del ejemplo muestra la forma; usa la del vehículo que vas a consultar.
Ejemplo de respuesta
{
"datos": {
"nota": "Aquí llega lo que entregó la fuente oficial en el momento de la consulta."
},
"fuente_oficial_url": "https://www.datos.gov.co/d/72nf-y4v3",
"creditos_usados": 1,
"creditos_restantes": 99
}
El ejemplo muestra los cuatro campos que siempre llegan. El contenido de «datos» es lo que entregue la fuente en el momento de la consulta; aquí no se escribe una muestra para no inventarla.
Lo que no se ofrece por la API
Estas consultas se hacen en el panel de KippiLex, con la cuenta del abogado y para su propio trabajo. No se entregan por la API ni por MCP.
Buscar sentencias de la Corte Constitucional · Corte Constitucional de Colombia
Leer una sentencia de la Corte Constitucional · Corte Constitucional de Colombia
Buscar normas (leyes, decretos, resoluciones) · Ministerio de Justicia y del Derecho — SUIN-Juriscol
Leer una norma con su estado de vigencia · Ministerio de Justicia y del Derecho — SUIN-Juriscol
Buscar conceptos de las superintendencias de Sociedades y Financiera · Superintendencia de Sociedades y Superintendencia Financiera de Colombia
Estado de un proceso judicial por su radicado (Rama Judicial) · Rama Judicial — Consulta de Procesos Nacional Unificada
Proceso de lo contencioso administrativo por su radicado (SAMAI) · Consejo de Estado — SAMAI
Buscar circulares externas, cartas circulares y resoluciones de la Superfinanciera · Superintendencia Financiera de Colombia
Buscar en qué edición del Diario Oficial se publicó una norma · Imprenta Nacional de Colombia
Los nombres de las entidades se usan para identificar el origen de cada dato; KippiLex no tiene vínculo con ellas ni las representa. KippiLex no es una firma de abogados y esto no constituye asesoría legal.
