Colombia lleva su contratación pública en dos sistemas y los dos siguen vivos. SECOP I, desde 2004, es un registro de publicación: la entidad sube lo que hizo. SECOP II, desde 2015, es una plataforma transaccional: el proceso ocurre dentro de ella. Publican columnas distintas, con palabras distintas y a granularidades distintas.
Eso convertía cualquier pregunta seria en dos preguntas. "Todo lo que esta empresa ha contratado con el Estado" significaba buscar dos veces y después conciliar dos formas que no coinciden en un solo campo.
Desde hoy son un solo corpus, con un solo vocabulario.
Diez datasets#
| Dataset | Qué contiene |
|---|---|
processes | Todos los procesos de compra, de ambos sistemas |
contracts | Todos los contratos firmados, de ambos sistemas |
awards | Cada proveedor adjudicado, no solo el primero |
modifications | Adiciones y prórrogas posteriores a la firma |
guarantees | Las pólizas que respaldan los contratos |
deliveries | El plan de entregas: lo prometido y lo que llegó |
bidders | Quién se presentó a cada proceso, incluidos los que perdieron |
suppliers | El registro de proveedores de SECOP II |
sanctions | Multas y sanciones a contratistas |
plans | El Plan Anual de Adquisiciones de cada entidad |
Un contrato de SECOP I y uno de SECOP II vuelven con los mismos nombres de campo. El documento del contratista se guarda en una sola forma, así que da igual si lo escribes 1234567890, 1234567890-1 o 1.234.567.890-1: los tres encuentran los mismos registros. Cada respuesta trae as_of, que dice hasta cuándo están al día los datos.
Un NIT, una llamada#
La pregunta más común sobre contratación pública es también la más incómoda de armar: qué ha hecho esta empresa con el Estado. Antes eran cuatro búsquedas y conciliarlas a mano. Ahora es una:
curl https://api.croma.run/co/secop/profile/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "document": "1234567890" }'Devuelve la cuenta de proveedor si existe, cuántos contratos ha firmado y los mayores, cuántas adjudicaciones ha ganado, en cuántos procesos se presentó, y todas las sanciones en su contra. Si el documento resulta ser el de una entidad pública, responde también por el otro lado del mercado: cuánto ha comprado y cuántos procesos ha publicado.
Los conteos son exactos. Las listas son las mayores, y el campo lo dice: contracts puede ser 412 mientras largest_contracts trae cinco. Para recorrer el resto está la búsqueda de contratos con el mismo documento.
Lo que ahora puedes preguntar#
Búsqueda por texto libre sobre el objeto de lo que se compra, combinable con la entidad, el departamento, la modalidad, el tipo de contrato, la categoría, el año, un rango de fechas y un rango de valores. Ordenable por monto:
curl https://api.croma.run/co/secop/contracts-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "recolección de residuos",
"department": "Antioquia",
"year": 2025,
"sort": "value_desc"
}'Dos preguntas que antes no tenían respuesta:
Quién más se presentó. bidders es la única vista publicada de los proponentes que perdieron, así que se puede medir qué tan disputado estuvo un proceso en vez de suponerlo.
Qué contratos crecieron después de adjudicarse. modifications-search ordenado por monto, con un piso, es la forma más directa de encontrarlos.
Todo esto está también en el MCP, con los mismos nombres y los mismos filtros.
Endpoints que se retiran#
Tres endpoints respondían una sola pregunta sobre SECOP II. La búsqueda que los reemplaza responde la misma pregunta sobre los dos sistemas, con filtros, paginación y orden. Siguen funcionando hasta el 1 de diciembre de 2026:
| Se retira | Usa en su lugar |
|---|---|
secop-contracts-by-provider | secop-contracts-search |
secop-processes-by-entity | secop-processes-search |
secop-sanctions-by-provider | secop-sanctions-search |
La documentación tiene el detalle de cada campo, y la fuente resume qué publica SECOP y desde cuándo.