SECOP

Resuelve un proceso de contratación pública colombiano de SECOP II (Sistema Electrónico de Contratación Pública), administrado por Colombia Compra Eficiente. Dado el noticeUID de un proceso, devuelve el encabezado del proceso más cada contrato adjudicado bajo él. Los datos provienen directamente de la publicación de datos abiertos de Colombia Compra Eficiente, uniendo los conjuntos de datos “Procesos de Contratación” y “Contratos Electrónicos”. Los contratos adjudicados se obtienen del conjunto de datos de contratos, que es la fuente autorizada de quién ganó realmente (los campos de adjudicación del propio registro del proceso se actualizan con retraso).

Solicitud

POST /co/secop/process/v1

Campo	Tipo	Notas
`notice_uid`	string	Obligatorio. noticeUID de SECOP, p. ej. `CO1.NTC.9458505`.

curl https://api.croma.run/co/secop/process/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "notice_uid": "CO1.NTC.9458505" }'

El noticeUID es el identificador del aviso del proceso, con el formato CO1.NTC.<number> (p. ej. CO1.NTC.9458505).

Búsqueda: contratos por proveedor

POST /co/secop/contracts-by-provider/v1 Lista los contratos adjudicados a un proveedor (cédula o NIT) a través de cada entidad contratante: el perfil del contratista.

Campo	Tipo	Notas
`provider_document`	string	Obligatorio. Cédula o NIT del proveedor (entre 4 y 20 caracteres alfanuméricos).

curl https://api.croma.run/co/secop/contracts-by-provider/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "provider_document": "79372917" }'

Devuelve provider_document, count, capped y contracts[] (la misma estructura de contrato que abajo). Limitado a 500, los más recientes primero; cuando capped es true, acota la búsqueda.

Búsqueda: procesos por entidad

POST /co/secop/processes-by-entity/v1 Lista los procesos de contratación publicados por una entidad contratante (por NIT), opcionalmente dentro de una ventana de fecha de publicación: la población a auditar de una entidad. Devuelve resúmenes ligeros; profundiza en uno con la consulta por noticeUID de arriba.

Campo	Tipo	Notas
`entity_nit`	string	Obligatorio. NIT de la entidad contratante (dígitos, sin dígito de verificación).
`from_date`	string	Opcional. Límite inferior de la fecha de publicación (`yyyy-mm-dd`, inclusive).
`to_date`	string	Opcional. Límite superior de la fecha de publicación (`yyyy-mm-dd`, inclusive).

curl https://api.croma.run/co/secop/processes-by-entity/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "entity_nit": "899999061", "from_date": "2026-01-01" }'

Devuelve entity_nit, from_date, to_date, count, capped y processes[], cada uno con notice_uid, process_id, name, entity, entity_nit, modality, contract_type, base_price, phase, procedure_status, published_date y url. Limitado a 500, los más recientes primero.

Respuesta

Campo	Notas
`found`	`true` cuando un proceso coincide con el noticeUID; `false` deja `process` en null y `contracts` vacío.
`notice_uid`	El noticeUID consultado.
`process`	El encabezado del proceso (ver abajo).
`contract_count`	Número de contratos adjudicados asociados.
`contracts`	Los contratos adjudicados (ver abajo).

`process`

Campo	Notas
`process_id`, `portfolio_id`	Ids de SECOP (`CO1.REQ.`, `CO1.BDOS.`).
`reference`	Número del proceso (referencia interna de la entidad).
`name`, `description`	Nombre y descripción del procedimiento.
`entity`, `entity_nit`, `entity_department`, `entity_city`, `entity_order`	Entidad contratante.
`procurement_unit`, `procurement_unit_city`	Unidad de contratación.
`modality`, `modality_justification`	Modalidad de contratación.
`contract_type`, `contract_subtype`	Tipo / subtipo de contrato.
`unspsc_code`, `additional_categories`	Códigos de categoría UNSPSC.
`duration`, `duration_unit`, `lots`	Duración y número de lotes.
`base_price`	Precio base estimado (COP).
`phase`, `status_summary`, `procedure_status`, `opening_status`	Fase y estados.
`published_date`, `last_published_date`	Fechas de publicación (`yyyy-mm-dd`).
`awarded`, `awarded_value`	Indicador/valor de adjudicación del conjunto de datos del proceso (se actualiza con retraso; prefiere `contracts`).
`invited_providers`, `responses`, `views`	Métricas de participación.
`url`	La página OpportunityDetail.

`contracts[]`

Campo	Notas
`contract_id`, `reference`	Id de contrato de SECOP (`CO1.PCCNTR.*`) y referencia.
`entity`, `entity_nit`	Entidad contratante.
`provider`, `provider_document`, `provider_document_type`, `provider_code`	El proveedor adjudicado.
`is_sme`, `legal_rep_name`	Es PyME / representante legal.
`status`, `contract_type`, `object`	Estado, tipo y objeto del contrato.
`value`	Valor del contrato (COP).
`invoiced_value`, `paid_value`, `pending_execution_value`, `pending_payment_value`	Montos de ejecución.
`sign_date`, `start_date`, `end_date`, `added_days`, `duration`	Cronograma del contrato.
`can_be_extended`, `location`	Prórroga y localización.
`supervisor`, `expense_orderer`, `funding_origin`	Supervisión y origen de los recursos.
`sector`, `branch`, `updated_date`	Sector, rama, última actualización.

Las cadenas de marcador de posición de SECOP (No Definido, No Aplica, etc.) se normalizan a null. Los campos monetarios y de conteo son números; las fechas son yyyy-mm-dd.

Un proceso también tiene secciones disponibles únicamente en el propio sitio de SECOP (Documentos Tipo, Cuestionario, Observaciones, descargas de documentos) o en otros conjuntos de datos (garantías, plan anual de adquisiciones, detalle del presupuesto). Esas no forman parte de esta respuesta.

Referencia completa

Esquemas, campos de respuesta y un playground interactivo.

Primeros pasos

Colombia

Perú

Global

Solicitud

Búsqueda: contratos por proveedor

Búsqueda: procesos por entidad

Respuesta

`process`

`contracts[]`

Referencia completa

​Solicitud

​Búsqueda: contratos por proveedor

​Búsqueda: procesos por entidad

​Respuesta

​process

​contracts[]

Referencia completa

Solicitud

Búsqueda: contratos por proveedor

Búsqueda: procesos por entidad

Respuesta

`process`

`contracts[]`