> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # SECOP > Consulta un proceso de contratación pública colombiano (SECOP II) por noticeUID, con sus contratos adjudicados. 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`. | ```bash theme={"dark"} 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.` (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). | ```bash theme={"dark"} 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). | ```bash theme={"dark"} 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. Esquemas, campos de respuesta y un playground interactivo.