SECOP

Resolves Colombian public-procurement records 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, the per-provider award list, and every contract awarded under it. Companion endpoints search by provider or entity, drill into one contract (with its additions, guarantees, and delivery plan), and list fines and sanctions against a contractor. The data comes from Colombia Compra Eficiente’s official publication of the SECOP II records. The awarded contracts come from the official contract records, which are authoritative for who actually won (the process record’s own award fields can lag).

Process by notice

POST /co/secop/process/v1

Field	Type	Notes
`notice_uid`	string	Required. SECOP noticeUID, e.g. `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" }'

The noticeUID is the process’s notice identifier, formatted like CO1.NTC.<number> (e.g. CO1.NTC.9458505).

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
`document_number`	string	Required. Provider cédula or NIT (4-20 alphanumeric).
`entity_nit`	string	Optional. Only contracts with this contracting entity (digits, no verification digit).
`from_date`	string	Optional. Sign date lower bound (`yyyy-mm-dd`, inclusive).
`to_date`	string	Optional. Sign date upper bound (`yyyy-mm-dd`, inclusive).
`page`	number	Optional. 1-based page of 500 (default 1).

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

Returns document_number, the echoed filters (entity_nit, from_date, to_date), count, capped, contracts[] (same contract shape as below), and a pagination object (total, page_size, total_pages, page). Pages of 500, newest first; when capped is true the page is full, so request the next page or narrow the 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
`document_number`	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).
`page`	number	Optional. 1-based page of 500 (default 1).

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

Returns document_number, from_date, to_date, count, capped, processes[] (each with notice_uid, process_id, name, entity, entity_nit, modality, contract_type, base_price, phase, procedure_status, published_date, and url), and a pagination object (total, page_size, total_pages, page). Pages of 500, newest first; when capped is true the page is full, so request the next page.

Contract by id

POST /co/secop/contract/v1 Resolves one electronic contract by its id and attaches its satellite history: registered additions/modifications, insurance policies (garantías), and the delivery plan with planned vs actual progress.

Field	Type	Notes
`contract_id`	string	Required. SECOP contract id, e.g. `CO1.PCCNTR.6794799`.

curl https://api.croma.run/co/secop/contract/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contract_id": "CO1.PCCNTR.6794799" }'

Returns found, contract_id, contract (same shape as contracts[] below), and three lists, each capped at 200 with a matching *_capped flag:

List	Fields
`additions[]`	`addition_id`, `type`, `description`, `registered_date`.
`guarantees[]`	`insurer`, `policy_number`, `insured`, `beneficiary`, `policy_created_date`, `policy_sent_date`, `policy_end_date`, `policy_side`, `status`, `policy_type`, `policy_subtype`, `value`, `created_date`.
`execution_items[]`	`execution_type`, `plan_name`, `expected_delivery_date`, `expected_progress_percent`, `actual_delivery_date`, `actual_progress_percent`, `contract_status`, `item_reference`, `description`, `unit`, `awarded_quantity`, `planned_quantity`, `received_quantity`, `pending_quantity`, `created_date`.

Sanctions by provider

POST /co/secop/sanctions-by-provider/v1 Lists the fines and sanctions (multas y sanciones) recorded against one state contractor. Records span 2010 to the present.

Field	Type	Notes
`document_number`	string	Required. Contractor cédula or NIT (4-20 alphanumeric).

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

Returns document_number, count, capped, and sanctions[], each with entity, entity_nit, entity_level, entity_order, municipality, resolution_number, provider, contract_number, sanction_value, published_date, final_date (fecha de firmeza), and url.

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).
`awards`	Per-provider award rows (see below), capped at 500.
`awards_capped`	`true` when the awards list hit its cap; `process.awarded_value`/`award_count` stay authoritative.
`contract_count`	Number of awarded contracts attached.
`contracts_capped`	`true` when the contracts list hit its cap and may be incomplete.
`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`).
`bid_deadline`	Deadline for providers to submit offers.
`awarded`, `awarded_value`, `award_count`, `award_date`	Award flag, total adjudicated across every award, how many awards it spans, and the award date (can lag; `contracts` is authoritative).
`invited_providers`, `directly_invited_providers`, `interested_providers`	Provider-funnel metrics.
`responses`, `external_responses`, `offer_responses`, `unique_responding_providers`, `views`	Participation metrics.
`url`	The OpportunityDetail page.

`awards[]`

One row per awarded provider (framework agreements award many):

Field	Notes
`provider`, `provider_nit`, `provider_code`	The awarded provider.
`provider_department`, `provider_city`	Provider location.
`awarded_value`	This provider’s slice of the process award (COP).
`award_date`	Fecha de adjudicación.

`contracts[]`

Field	Notes
`contract_id`, `reference`	SECOP contract id (`CO1.PCCNTR.*`) and reference.
`entity`, `entity_nit`, `centralized_entity`	Contracting entity (`Centralizada`/`Descentralizada`).
`provider`, `provider_document`, `provider_document_type`, `provider_code`	The awarded provider.
`is_sme`, `is_group`	Es PyME / plural structure (unión temporal, consorcio).
`legal_rep_name`, `legal_rep_document_type`, `legal_rep_document`	Representante legal and their identity document.
`status`, `contract_type`, `object`	Estado, tipo y objeto del contrato.
`modality`, `modality_justification`	How the contract was procured (direct contracting vs tender).
`unspsc_code`	UNSPSC category code.
`delivery_conditions`	Condiciones de entrega.
`value`	Valor del contrato (COP).
`invoiced_value`, `paid_value`, `pending_execution_value`, `pending_payment_value`	Execution amounts.
`advance_payment_enabled`, `advance_payment_value`, `amortized_value`, `pending_amortization_value`	Advance-payment exposure and amortization.
`sign_date`, `start_date`, `end_date`, `added_days`, `duration`	Cronograma del contrato.
`can_be_extended`, `extension_notice_date`	Prórroga and its notice date.
`requires_liquidation`, `liquidation_start_date`, `liquidation_end_date`	Liquidación stage and window.
`has_environmental_obligation`, `has_post_consumption_obligations`, `has_reversion`	Contractual obligation flags.
`location`	Localización.
`supervisor`, `expense_orderer`, `funding_origin`, `expense_destination`	Supervisión, origen de los recursos, destino del gasto (`Inversión`/`Funcionamiento`).
`sector`, `branch`, `updated_date`	Sector, rama, última actualización.

Empty and placeholder values 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 SECOP records (plan anual de adquisiciones, presupuesto detail). Those are not part of these responses.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Countries

Process by notice

Contracts by provider

Processes by entity

Contract by id

Sanctions by provider

Response

`process`

`awards[]`

`contracts[]`

Full reference

​Process by notice

​Contracts by provider

​Processes by entity

​Contract by id

​Sanctions by provider

​Response

​process

​awards[]

​contracts[]

Full reference

Process by notice

Contracts by provider

Processes by entity

Contract by id

Sanctions by provider

Response

`process`

`awards[]`

`contracts[]`