SECOP

A Colômbia conduziu a contratação pública em dois sistemas. O SECOP I (desde 2004) é um registro de publicação: a entidade envia o que fez. O SECOP II (desde 2015) é uma plataforma transacional: o processo acontece dentro dela. Ambos são administrados pela Colombia Compra Eficiente, ambos continuam recebendo registros, e publicam colunas diferentes, com palavras diferentes e em granularidades diferentes. A Croma serve ambos como um único corpus. Sete conjuntos de dados (processos, contratos, modificações de contratos, proponentes, fornecedores, sanções e planos anuais de aquisições) estão completos, mantidos em dia e respondidos com um vocabulário único, de modo que uma pergunta como “tudo o que esta empresa contratou com o Estado” é uma única chamada e não duas buscas em duas formas distintas. Cada resposta inclui as_of, até quando os dados estão em dia. Dois endpoints ainda leem a fonte ao vivo, porque respondem sobre um registro e não sobre o corpus: secop-process retorna um processo do SECOP II com suas adjudicações por fornecedor e seus contratos, e secop-contract retorna um contrato com suas adições, garantias e plano de entregas.

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

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

Buscar processos

POST /co/secop/processes-search/v1 Dataset Busca todos os processos de contratação publicados no SECOP II e SECOP I como um único corpus. Os filtros se combinam livremente; query busca no nome, na descrição, na entidade e na referência do processo.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`platform`	enum	`secop_ii`, `secop_i` ou `any` para ambos. Por padrão `any`.
`entity_nit`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`department`	string	Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, …). Empty for the whole country.
`modality`	string	Optional modalidad de contratación, exactly as SECOP writes it (`Contratación directa`, `Licitación pública`, `Mínima cuantía`, …). Empty for every modality.
`contract_type`	string	Optional tipo de contrato, exactly as SECOP writes it (`Prestación de servicios`, `Obra`, `Suministros`, …). Empty for every type.
`status`	string	Optional estado, exactly as SECOP writes it (`Adjudicado`, `Celebrado`, `En ejecución`, `Terminado`, …). Empty for every status.
`unspsc_code`	string	Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`from_date`	string	Optional date filter in yyyy-mm-dd format.
`to_date`	string	Optional date filter in yyyy-mm-dd format.
`min_value`	number	Os limites aplicam-se a `base_price` (o valor estimado do processo), em COP. Por padrão `0`.
`max_value`	number	Os limites aplicam-se a `base_price` (o valor estimado do processo), em COP. Por padrão `0`.
`sort`	enum	Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`. Por padrão `recent`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.
`awarded`	enum	Restrict to processes that reached an award (`yes`), that did not (`no`), or `any`. Processes whose outcome the source does not state are excluded by `yes` and `no` alike. Por padrão `any`.

curl https://api.croma.run/co/secop/processes-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "recolección de residuos", "year": 2025, "per_page": 20 }'

Retorna as_of (até quando os dados estão em dia), total, page, per_page, total_pages, count, os filtros como foram aplicados e results[]. Cada resultado é um registro de processo: seu id com prefixo de plataforma, a entidade compradora, o objeto, a modalidade e o tipo de contrato, os valores estimado e adjudicado, as datas, as contagens de competição que o SECOP II publica (invited_providers, unique_responding_providers, …) e a URL do processo. Use o id de um resultado com secop-process-record para lê-lo isoladamente, ou seu notice_uid com secop-process para a visão ao vivo com adjudicações e contratos.

Buscar contratos

POST /co/secop/contracts-search/v1 Dataset Busca todos os contratos assinados através do SECOP II e SECOP I como um único corpus. provider_document aceita um NIT ou cédula com ou sem pontos e dígito verificador: 900195855, 900.195.855-1 e 900195855-1 correspondem ao mesmo contratado.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`platform`	enum	Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both. Por padrão `any`.
`entity_nit`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`department`	string	Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, …). Empty for the whole country.
`modality`	string	Optional modalidad de contratación, exactly as SECOP writes it (`Contratación directa`, `Licitación pública`, `Mínima cuantía`, …). Empty for every modality.
`contract_type`	string	Optional tipo de contrato, exactly as SECOP writes it (`Prestación de servicios`, `Obra`, `Suministros`, …). Empty for every type.
`status`	string	Optional estado, exactly as SECOP writes it (`Adjudicado`, `Celebrado`, `En ejecución`, `Terminado`, …). Empty for every status.
`unspsc_code`	string	Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`from_date`	string	Optional date filter in yyyy-mm-dd format.
`to_date`	string	Optional date filter in yyyy-mm-dd format.
`min_value`	number	Os limites aplicam-se a `value_with_additions` (o efetivamente comprometido), em COP. Por padrão `0`.
`max_value`	number	Os limites aplicam-se a `value_with_additions` (o efetivamente comprometido), em COP. Por padrão `0`.
`sort`	enum	Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`. Por padrão `recent`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.
`provider_document`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`sector`	string	Publicado apenas em contratos do SECOP II; ao usá-lo, o SECOP I é excluído.

curl https://api.croma.run/co/secop/contracts-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "provider_document": "900195855",
        "sort": "value_desc",
        "per_page": 20
      }'

Retorna as_of, os metadados de página, os filtros aplicados e results[]. Cada resultado é um registro de contrato com a entidade, o contratado e seu representante legal, o objeto, os valores (assinado, com adições, faturado, pago, pendente), a composição das fontes de financiamento, as datas, os marcadores de pós-conflito e Acordo de Paz, e quem o supervisiona. value é o valor na assinatura; value_with_additions é o valor pelo qual convém ordenar o gasto. Use o id de um resultado com secop-contract-record, ou seu contract_id com secop-contract para a visão ao vivo com adições, garantias e plano de entregas.

Buscar modificações de contratos

POST /co/secop/modifications-search/v1 Dataset Lista o que aconteceu com os contratos depois de assinados. Ordenar por value_desc com um piso em min_value é a forma mais direta de encontrar os contratos que mais cresceram após a adjudicação.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`contract_id`	string	Um `id` de contrato de `secop-contracts-search`, p. ex. `secop_ii:CO1.PCCNTR.4168447`.
`platform`	enum	Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both. Por padrão `any`.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`from_date`	string	Optional date filter in yyyy-mm-dd format.
`to_date`	string	Optional date filter in yyyy-mm-dd format.
`min_value`	number	Optional lower bound on the amount, in COP. 0 means no lower bound. Por padrão `0`.
`sort`	enum	Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`. Por padrão `recent`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/modifications-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "min_value": 1000000000, "sort": "value_desc", "per_page": 20 }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com contract_id, kind, description, added_value, added_days e registered_date. O SECOP I registra suas adições contra a adjudicação e não contra a linha do contrato, portanto elas trazem contract_reference (o id de adjudicação, que um contrato reporta como award_id) em vez de contract_id.

Buscar fornecedores

POST /co/secop/suppliers-search/v1 Dataset O registro de fornecedores do SECOP II. query busca no nome, no documento e na descrição da categoria registrada.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`document`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`department`	string	Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, …). Empty for the whole country.
`unspsc_code`	string	Optional main UNSPSC category code of the purchase (`V1.80101500`). Empty for every category.
`active`	enum	Restrict to active supplier accounts (`yes`), inactive ones (`no`), or `any`. Por padrão `any`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/suppliers-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "constructora", "department": "Antioquia", "per_page": 20 }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com o document do fornecedor, name, categoria, localização, dados de contato, representante legal e is_active. O SECOP I não tem registro de fornecedores próprio; um contratado do SECOP I aparece em secop-contracts-search mas não aqui.

Buscar proponentes

POST /co/secop/bidders-search/v1 Dataset Quem apresentou proposta em qual processo. O SECOP I também publica a nota e se o proponente venceu; o SECOP II publica apenas a participação, então lá score e awarded são nulos em vez de inferidos.

Campo	Tipo	Notas
`process_id`	string	Para SECOP II, um `id` de processo de `secop-processes-search`. O SECOP I identifica o processo aqui com um id interno próprio, que não é essa chave.
`bidder_document`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`platform`	enum	Restrict to one system: `secop_ii` (the transactional platform, 2015 onward), `secop_i` (the publication register, 2004 onward), or `any` for both. Por padrão `any`.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/bidders-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "bidder_document": "900195855", "per_page": 20 }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com process_id, bidder, bidder_document, score, awarded e published_date.

Buscar sanções

POST /co/secop/sanctions-search/v1 Dataset Todo o registro de multas e sanções, consultável através de contratados e entidades em vez de um contratado por vez.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`provider_document`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`entity_nit`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`from_date`	string	Optional date filter in yyyy-mm-dd format.
`to_date`	string	Optional date filter in yyyy-mm-dd format.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/sanctions-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "incumplimiento", "per_page": 20 }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com a entidade sancionadora, o contratado, o número da resolução, o contrato, o valor em COP, a data de publicação e a data em que a sanção transitou em julgado.

Buscar planos anuais de aquisições

POST /co/secop/plans-search/v1 Dataset A metade prospectiva da contratação colombiana: o que as entidades dizem que vão comprar, antes de os processos existirem.

Campo	Tipo	Notas
`query`	string	Busca no nome da entidade e na missão e perspectiva estratégica que declara no plano. O cabeçalho identifica a entidade pelo código SECOP e não por NIT, portanto aqui chega-se a uma entidade por nome e não por documento.
`department`	string	Optional department of the contracting entity, as SECOP writes it (`Antioquia`, `Bogotá D.C.`, …). Empty for the whole country.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/plans-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "year": 2026, "per_page": 20 }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com a entidade, o ano, o orçamento total anunciado, os limites de menor e mínima quantia, a missão e perspectiva estratégica declaradas e o contato registrado.

Perfil por documento

POST /co/secop/profile/v1 Dataset Um documento, os dois lados do mercado. Um NIT pode ser contratado, entidade compradora ou ambos, e isto responde por tudo de uma vez.

Campo	Tipo	Notas
`document`	string	Obrigatório. Provider cédula or NIT. Dots and a trailing verification digit are optional: `900195855`, `900195855-1` and `900.195.855-1` all match the same contractor.
`per_section`	integer	Apenas o tamanho de cada lista. As contagens ao lado delas são totais exatos de qualquer forma. Por padrão `5`.

curl https://api.croma.run/co/secop/profile/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document": "900195855" }'

As contagens são exatas; as listas são as maiores. as_contractor.contracts é o número real de contratos mesmo que largest_contracts traga cinco. Para percorrer o resto, use o document e chame secop-contracts-search. contracts_value é a soma dos contratos efetivamente retornados e nada mais. Não é um total histórico: um total sobre todos os contratos não é algo que este endpoint possa calcular, e um número inferido de uma página estaria errado na direção que ninguém verificaria. found: false significa que não há nada para esse documento. É uma resposta, não um erro: a maioria das cédulas nunca contratou com o Estado.

Buscar adjudicações

POST /co/secop/awards-search/v1 Dataset Cada fornecedor adjudicado em cada processo do SECOP II, na granularidade em que a fonte os publica. Uma linha do SECOP I já é uma adjudicação, com contratado e valor, portanto as adjudicações do SECOP I estão em secop-contracts-search.

Campo	Tipo	Notas
`query`	string	Optional search terms matched against the free text of the record (what is being bought, the entity and the supplier). Leave empty to filter without searching.
`provider_document`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`entity_nit`	string	Optional document filter: a NIT or a cédula, with or without dots and verification digit (`900195855`, `900.195.855-1` and `900195855-1` all match the same records).
`process_id`	string	Optional process id from a search result (`id` on a process, or `process_id` on a bidder). Empty searches every process.
`year`	integer	Optional calendar year. 0 searches every year. Por padrão `0`.
`from_date`	string	Optional date filter in yyyy-mm-dd format.
`to_date`	string	Optional date filter in yyyy-mm-dd format.
`min_value`	number	Os limites aplicam-se a `value`, a parcela da adjudicação deste fornecedor, não o total do processo. Por padrão `0`.
`max_value`	number	Os limites aplicam-se a `value`, a parcela da adjudicação deste fornecedor, não o total do processo. Por padrão `0`.
`sort`	enum	Order of the results: `recent` (newest first, the default), `oldest`, `value_desc` (largest amount first) or `value_asc`. Por padrão `recent`.
`page`	integer	1-based page number for paginated results. Por padrão `1`.
`per_page`	integer	Results per page (1-100). Por padrão `20`.

curl https://api.croma.run/co/secop/awards-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "provider_document": "900195855",
        "sort": "value_desc",
        "per_page": 20
      }'

Retorna as_of, os metadados de página, os filtros aplicados e results[] com process_id, notice_uid, a entidade, o fornecedor e seu documento, value e awarded_at. Use o process_id de um resultado com secop-process-record, ou seu notice_uid com secop-process para o processo com todas as suas adjudicações e contratos.

Ler um processo

POST /co/secop/process-record/v1 Dataset Retorna um único registro de processo pelo id que uma busca devolveu.

Campo	Tipo	Notas
`record_id`	string	Obrigatório. Record id from a SECOP search result (`id`), platform-prefixed: e.g. `secop_ii:CO1.PCCNTR.4168447`, `secop_i:20-11-10442331`.

curl https://api.croma.run/co/secop/process-record/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "record_id": "secop_ii:CO1.REQ.1234567" }'

Retorna as_of, found, o record_id consultado e process. Um record_id que não corresponde a nada responde found: false com process nulo; isso é uma resposta, não um erro.

Ler um contrato

POST /co/secop/contract-record/v1 Dataset Retorna um único registro de contrato pelo id que uma busca devolveu.

Campo	Tipo	Notas
`record_id`	string	Obrigatório. Record id from a SECOP search result (`id`), platform-prefixed: e.g. `secop_ii:CO1.PCCNTR.4168447`, `secop_i:20-11-10442331`.

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

Retorna as_of, found, o record_id consultado e contract. Um record_id que não corresponde a nada responde found: false com contract nulo.

Contratos por fornecedor

Este endpoint está descontinuado desde 2026-08-30 e deixará de responder em 2026-12-01. Use o seu sucessor, POST /co/secop/contracts-search/v1, no lugar.

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 (4-20 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`	integer	Opcional. Página de 500, começa em 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

Este endpoint está descontinuado desde 2026-08-30 e deixará de responder em 2026-12-01. Use o seu sucessor, POST /co/secop/processes-search/v1, no lugar.

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`	integer	Opcional. Página de 500, começa em 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.

Sanções por fornecedor

Este endpoint está descontinuado desde 2026-08-30 e deixará de responder em 2026-12-01. Use o seu sucessor, POST /co/secop/sanctions-search/v1, no lugar.

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 contratado (4-20 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, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Países

Processo por noticeUID

Contrato por id

Buscar processos

Buscar contratos

Buscar modificações de contratos

Buscar fornecedores

Buscar proponentes

Buscar sanções

Buscar planos anuais de aquisições

Perfil por documento

Buscar adjudicações

Ler um processo

Ler um contrato

Contratos por fornecedor

Processos por entidade

Sanções por fornecedor

Resposta

`process`

`awards[]`

`contracts[]`

Referência completa

​Processo por noticeUID

​Contrato por id

​Buscar processos

​Buscar contratos

​Buscar modificações de contratos

​Buscar fornecedores

​Buscar proponentes

​Buscar sanções

​Buscar planos anuais de aquisições

​Perfil por documento

​Buscar adjudicações

​Ler um processo

​Ler um contrato

​Contratos por fornecedor

​Processos por entidade

​Sanções por fornecedor

​Resposta

​process

​awards[]

​contracts[]

Referência completa

Processo por noticeUID

Contrato por id

Buscar processos

Buscar contratos

Buscar modificações de contratos

Buscar fornecedores

Buscar proponentes

Buscar sanções

Buscar planos anuais de aquisições

Perfil por documento

Buscar adjudicações

Ler um processo

Ler um contrato

Contratos por fornecedor

Processos por entidade

Sanções por fornecedor

Resposta

`process`

`awards[]`

`contracts[]`