> ## 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 > Look up a Colombian public-procurement process (SECOP II) by notice UID, with its awarded contracts. Resolves a Colombian public-procurement process from SECOP II (Sistema Electrónico de Contratación Pública), run by Colombia Compra Eficiente. Given the `noticeUID` of a process, it returns the process header plus every contract awarded under it. The data comes from Colombia Compra Eficiente's first-party open-data publication, joining the "Procesos de Contratación" and "Contratos Electrónicos" datasets. The awarded contracts are sourced from the contracts dataset, which is authoritative for who actually won (the process record's own award fields lag). ## Request `POST /co/secop/process/v1` | Field | Type | Notes | | ------------ | ------ | ------------------------------------------------------ | | `notice_uid` | string | **Required.** SECOP noticeUID, e.g. `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" }' ``` The `noticeUID` is the process's notice identifier, formatted like `CO1.NTC.` (e.g. `CO1.NTC.9458505`). ## Search: contracts by provider `POST /co/secop/contracts-by-provider/v1` Lists the contracts awarded to one provider (cédula or NIT) across every contracting entity: the contractor profile. | Field | Type | Notes | | ------------------- | ------ | --------------------------------------------------------- | | `provider_document` | string | **Required.** Provider cédula or NIT (4-20 alphanumeric). | ```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" }' ``` Returns `provider_document`, `count`, `capped`, and `contracts[]` (same contract shape as below). Capped at 500, newest first; when `capped` is `true`, narrow the search. ## Search: processes by entity `POST /co/secop/processes-by-entity/v1` Lists the procurement processes published by one contracting entity (by NIT), optionally within a publication-date window: the audit population for an entity. Returns lean summaries; drill into one with the by-notice lookup above. | Field | Type | Notes | | ------------ | ------ | --------------------------------------------------------------------- | | `entity_nit` | string | **Required.** Contracting entity NIT (digits, no verification digit). | | `from_date` | string | Optional. Publication date lower bound (`yyyy-mm-dd`, inclusive). | | `to_date` | string | Optional. Publication date upper bound (`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" }' ``` Returns `entity_nit`, `from_date`, `to_date`, `count`, `capped`, and `processes[]`, each with `notice_uid`, `process_id`, `name`, `entity`, `entity_nit`, `modality`, `contract_type`, `base_price`, `phase`, `procedure_status`, `published_date`, and `url`. Capped at 500, newest first. ## Response | Field | Notes | | ---------------- | ------------------------------------------------------------------------------------------------- | | `found` | `true` when a process matches the noticeUID; `false` leaves `process` null and `contracts` empty. | | `notice_uid` | The queried noticeUID. | | `process` | The process header (see below). | | `contract_count` | Number of awarded contracts attached. | | `contracts` | The awarded contracts (see below). | ### `process` | Field | Notes | | -------------------------------------------------------------------------- | --------------------------------------------------------------------- | | `process_id`, `portfolio_id` | SECOP ids (`CO1.REQ.*`, `CO1.BDOS.*`). | | `reference` | Número del proceso (entity's internal reference). | | `name`, `description` | Nombre y descripción del procedimiento. | | `entity`, `entity_nit`, `entity_department`, `entity_city`, `entity_order` | Contracting entity. | | `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` | UNSPSC category codes. | | `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` | Award flag/value from the process dataset (lags; prefer `contracts`). | | `invited_providers`, `responses`, `views` | Participation metrics. | | `url` | The OpportunityDetail page. | ### `contracts[]` | Field | Notes | | ---------------------------------------------------------------------------------- | ------------------------------------------------- | | `contract_id`, `reference` | SECOP contract id (`CO1.PCCNTR.*`) and reference. | | `entity`, `entity_nit` | Contracting entity. | | `provider`, `provider_document`, `provider_document_type`, `provider_code` | The awarded provider. | | `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` | Execution amounts. | | `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. | SECOP placeholder strings (`No Definido`, `No Aplica`, etc.) are normalized to `null`. Monetary and count fields are numbers; dates are `yyyy-mm-dd`. A process also has sections available only on SECOP's own site (Documentos Tipo, Cuestionario, Observaciones, document downloads) or in other datasets (garantías, plan anual de adquisiciones, presupuesto detail). Those are not part of this response. Schemas, response fields, and an interactive playground.