SECOP

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`.

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).

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).

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).

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.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Colombia

Peru

Global

Request

Search: contracts by provider

Search: processes by entity

Response

`process`

`contracts[]`

Full reference

​Request

​Search: contracts by provider

​Search: processes by entity

​Response

​process

​contracts[]

Full reference

Request

Search: contracts by provider

Search: processes by entity

Response

`process`

`contracts[]`