SECOP

Resolve registros de contratação pública colombiana do SECOP II (Sistema Electrónico de Contratación Pública), administrado pela Colombia Compra Eficiente. Dado o noticeUID de um processo, retorna o cabeçalho do processo, a lista de adjudicações por fornecedor e cada contrato adjudicado sob ele. Endpoints complementares buscam por fornecedor ou entidade, aprofundam em um contrato (com suas adições, garantias e plano de entregas) e listam as multas e sanções contra um contratista. Os dados provêm da publicação oficial dos registros do SECOP II da Colombia Compra Eficiente. Os contratos adjudicados são obtidos dos registros oficiais de contratos, que são a fonte autorizada de quem realmente ganhou (os campos de adjudicação do próprio registro do processo são atualizados com atraso).

Processo por noticeUID

POST /co/secop/process/v1

Campo	Tipo	Notas
`notice_uid`	string	Obrigatório. noticeUID do SECOP, p. ex. `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" }'

O noticeUID é o identificador do aviso do processo, com o formato CO1.NTC.<number> (p. ex. CO1.NTC.9458505).

Contratos por fornecedor

POST /co/secop/contracts-by-provider/v1 Lista os contratos adjudicados a um fornecedor (cédula ou NIT) através de cada entidade contratante: o perfil do contratista.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. Cédula ou NIT do fornecedor (entre 4 e 20 caracteres alfanuméricos).
`entity_nit`	string	Opcional. Apenas contratos com esta entidade contratante (dígitos, sem dígito de verificação).
`from_date`	string	Opcional. Limite inferior da data de assinatura (`yyyy-mm-dd`, inclusive).
`to_date`	string	Opcional. Limite superior da data de assinatura (`yyyy-mm-dd`, inclusive).
`page`	number	Opcional. Página de 500, base 1 (por padrão 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" }'

Retorna document_number, os filtros aplicados (entity_nit, from_date, to_date), count, capped, contracts[] (a mesma estrutura de contrato que abaixo) e um objeto pagination (total, page_size, total_pages, page). Páginas de 500, os mais recentes primeiro; quando capped é true a página está cheia, então solicite a próxima page ou restrinja a busca.

Processos por entidade

POST /co/secop/processes-by-entity/v1 Lista os processos de contratação publicados por uma entidade contratante (por NIT), opcionalmente dentro de uma janela de data de publicação: a população a auditar de uma entidade. Retorna resumos leves; aprofunde em um deles com a consulta por noticeUID acima.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. NIT da entidade contratante (dígitos, sem dígito de verificação).
`from_date`	string	Opcional. Limite inferior da data de publicação (`yyyy-mm-dd`, inclusive).
`to_date`	string	Opcional. Limite superior da data de publicação (`yyyy-mm-dd`, inclusive).
`page`	number	Opcional. Página de 500, base 1 (por padrão 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" }'

Retorna document_number, from_date, to_date, count, capped, processes[] (cada um com notice_uid, process_id, name, entity, entity_nit, modality, contract_type, base_price, phase, procedure_status, published_date e url) e um objeto pagination (total, page_size, total_pages, page). Páginas de 500, os mais recentes primeiro; quando capped é true a página está cheia, então solicite a próxima page.

Contrato por id

POST /co/secop/contract/v1 Resolve um contrato eletrônico pelo seu id e anexa seu histórico satélite: adições/modificações registradas, apólices de garantia e o plano de entregas com avanço planejado vs real.

Campo	Tipo	Notas
`contract_id`	string	Obrigatório. Id de contrato do SECOP, p. ex. `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" }'

Retorna found, contract_id, contract (a mesma estrutura que contracts[] abaixo) e três listas, cada uma limitada a 200 com seu indicador *_capped:

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

Sanções por fornecedor

POST /co/secop/sanctions-by-provider/v1 Lista as multas e sanções registradas contra um contratista do Estado. Os registros cobrem desde 2010 até o presente.

Campo	Tipo	Notas
`document_number`	string	Obrigatório. Cédula ou NIT do contratista (entre 4 e 20 caracteres alfanuméricos).

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" }'

Retorna document_number, count, capped e sanctions[], cada uma com entity, entity_nit, entity_level, entity_order, municipality, resolution_number, provider, contract_number, sanction_value, published_date, final_date (data de firmeza) e url.

Resposta

Campo	Notas
`found`	`true` quando um processo coincide com o noticeUID; `false` deixa `process` em null e `contracts` vazio.
`notice_uid`	O noticeUID consultado.
`process`	O cabeçalho do processo (ver abaixo).
`awards`	Linhas de adjudicação por fornecedor (ver abaixo), limitadas a 500.
`awards_capped`	`true` quando a lista de adjudicações atingiu seu limite; `process.awarded_value`/`award_count` continuam sendo a fonte autorizada.
`contract_count`	Número de contratos adjudicados associados.
`contracts_capped`	`true` quando a lista de contratos atingiu seu limite e pode estar incompleta.
`contracts`	Os contratos adjudicados (ver abaixo).

`process`

Campo	Notas
`process_id`, `portfolio_id`	Ids do SECOP (`CO1.REQ.`, `CO1.BDOS.`).
`reference`	Número do processo (referência interna da entidade).
`name`, `description`	Nome e descrição do procedimento.
`entity`, `entity_nit`, `entity_department`, `entity_city`, `entity_order`	Entidade contratante.
`procurement_unit`, `procurement_unit_city`	Unidade de contratação.
`modality`, `modality_justification`	Modalidade de contratação.
`contract_type`, `contract_subtype`	Tipo / subtipo de contrato.
`unspsc_code`, `additional_categories`	Códigos de categoria UNSPSC.
`duration`, `duration_unit`, `lots`	Duração e número de lotes.
`base_price`	Preço base estimado (COP).
`phase`, `status_summary`, `procedure_status`, `opening_status`	Fase e estados.
`published_date`, `last_published_date`	Datas de publicação (`yyyy-mm-dd`).
`bid_deadline`	Data limite de recebimento de ofertas.
`awarded`, `awarded_value`, `award_count`, `award_date`	Indicador de adjudicação, valor total adjudicado entre todas as adjudicações, quantas são e a data de adjudicação (atualizado com atraso; `contracts` é a fonte autorizada).
`invited_providers`, `directly_invited_providers`, `interested_providers`	Métricas do funil de fornecedores.
`responses`, `external_responses`, `offer_responses`, `unique_responding_providers`, `views`	Métricas de participação.
`url`	A página OpportunityDetail.

`awards[]`

Uma linha por fornecedor adjudicado (os acordos-quadro adjudicam a muitos):

Campo	Notas
`provider`, `provider_nit`, `provider_code`	O fornecedor adjudicado.
`provider_department`, `provider_city`	Localização do fornecedor.
`awarded_value`	A parcela deste fornecedor na adjudicação do processo (COP).
`award_date`	Data de adjudicação.

`contracts[]`

Campo	Notas
`contract_id`, `reference`	Id de contrato do SECOP (`CO1.PCCNTR.*`) e referência.
`entity`, `entity_nit`, `centralized_entity`	Entidade contratante (`Centralizada`/`Descentralizada`).
`provider`, `provider_document`, `provider_document_type`, `provider_code`	O fornecedor adjudicado.
`is_sme`, `is_group`	É PME / estrutura plural (unión temporal, consórcio).
`legal_rep_name`, `legal_rep_document_type`, `legal_rep_document`	Representante legal e seu documento de identidade.
`status`, `contract_type`, `object`	Estado, tipo e objeto do contrato.
`modality`, `modality_justification`	Modalidade de contratação do contrato (contratação direta vs licitação).
`unspsc_code`	Código de categoria UNSPSC.
`delivery_conditions`	Condições de entrega.
`value`	Valor do contrato (COP).
`invoiced_value`, `paid_value`, `pending_execution_value`, `pending_payment_value`	Montantes de execução.
`advance_payment_enabled`, `advance_payment_value`, `amortized_value`, `pending_amortization_value`	Pagamento antecipado e sua amortização.
`sign_date`, `start_date`, `end_date`, `added_days`, `duration`	Cronograma do contrato.
`can_be_extended`, `extension_notice_date`	Prorrogação e sua data de notificação.
`requires_liquidation`, `liquidation_start_date`, `liquidation_end_date`	Etapa de liquidação e sua janela.
`has_environmental_obligation`, `has_post_consumption_obligations`, `has_reversion`	Indicadores de obrigações contratuais.
`location`	Localização.
`supervisor`, `expense_orderer`, `funding_origin`, `expense_destination`	Supervisão, origem dos recursos, destino do gasto (`Inversión`/`Funcionamiento`).
`sector`, `branch`, `updated_date`	Setor, ramo, última atualização.

Os valores vazios ou de preenchimento são normalizados para null. Os campos monetários e de contagem são números; as datas são yyyy-mm-dd.

Um processo também tem seções disponíveis apenas no próprio site do SECOP (Documentos Tipo, Cuestionario, Observaciones, downloads de documentos) ou em outros registros do SECOP (plano anual de aquisições, detalhe do orçamento). Essas não fazem parte destas respostas.

Referência completa

Esquemas, campos de resposta e um playground interativo.

Primeiros passos

Países

Processo por noticeUID

Contratos por fornecedor

Processos por entidade

Contrato por id

Sanções por fornecedor

Resposta

`process`

`awards[]`

`contracts[]`

Referência completa

​Processo por noticeUID

​Contratos por fornecedor

​Processos por entidade

​Contrato por id

​Sanções por fornecedor

​Resposta

​process

​awards[]

​contracts[]

Referência completa

Processo por noticeUID

Contratos por fornecedor

Processos por entidade

Contrato por id

Sanções por fornecedor

Resposta

`process`

`awards[]`

`contracts[]`