Catalog / Tenders & public contracts
TENDERS & PUBLIC CONTRACTS · COLOMBIA
Colombia SECOP Contracts + Company Registry
Scrape Colombia SECOP II awarded contracts by keyword, buyer, supplier NIT or signing date.
About this data
Scrape Colombia SECOP II awarded contracts by keyword, buyer, supplier NIT or signing date. One row per contract with buyer, supplier, COP value, dates, object and process link, joined to the supplier's public RUES company record (status, CIIU activity). Daily new-only feed; JSON, CSV or Excel.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
Colombia SECOP II Contracts
POST /v1/co/secop/contracts
Colombian public contract awards from SECOP II: buyer, supplier, value, dates and process link.
Input
Send a JSON body to POST https://api.ssh.autos/v1/co/secop/contracts.
| Field | Type | Required | Notes |
|---|---|---|---|
supplier | string | optional | up to 150 characters |
buyer | string | optional | up to 150 characters |
keyword | string | optional | up to 150 characters |
maxResults | integer | optional | 1–10; default 5 |
Returned fields
The answer is JSON: records, a list of up to 10, and summary, the run status and counts. Each record has these 41 fields; a field the source does not publish comes back null.
41 fields per record
| Field | Type | Notes |
|---|---|---|
contractKey | string | Composite unique key: source:contrato:idContrato (e.g. datos.gov.co:contrato:CO1.PCCNTR.9755406). |
idContrato | string | SECOP contract id, e.g. 'CO1.PCCNTR.3524727'. |
referenciaContrato | string | Contract reference as printed, e.g. '232-00-A-COFAC-CODAF-2026'. |
idProceso | string | Procurement process (notice) id, e.g. 'CO1.BDOS.10565635'. |
buyerNit | string | Buyer entity's NIT, when published. |
buyerName | string | Buyer entity name (nombre entidad). |
departamento | string | Colombian department of the buyer. |
ciudad | string | City/municipality of the buyer. |
supplierDocType | string | Supplier document type (CC, NIT, CE...). |
supplierNit | string | Supplier's NIT / document number (formats vary: '900156264', '07.689.002/0001-89'). |
supplierName | string | Supplier name (proveedor adjudicado). |
amount | number | Contract value in COP. |
currency | string | Currency of amount: COP (SECOP II publishes values in Colombian pesos). |
amountPaid | number | Value already paid against the contract (valor pagado), COP. |
signedAt | string | Contract signing date (fecha de firma), ISO YYYY-MM-DD. |
startDate | string | Contract start date, ISO YYYY-MM-DD. |
endDate | string | Contract end date, ISO YYYY-MM-DD. |
objeto | string | Contract object (what is being bought). |
tipoContrato | string | Contract type, e.g. 'Prestación de servicios'. |
modalidad | string | Contracting modality, e.g. 'Contratación directa'. |
estado | string | Contract state, e.g. 'En ejecución'. |
url | string | SECOP process page (URLProceso). |
sourceQuery | string | The scope this run searched (filters, or 'latest'). |
source | string | Source API hostname (datos.gov.co). |
scrapedAt | string | UTC ISO-8601 collection timestamp. |
supplierRegistry | array | — |
registryMatchMethod | string | — |
registryStatus | string | — |
windowComplete | boolean | — |
rowType | string | — |
supplierNitNormalized | string | — |
awardCount | integer | — |
totalValue | number | — |
topBuyers | array | — |
windowValueShare | number | — |
coverage | string | — |
dateFrom | string | — |
dateTo | string | — |
note | string | — |
error | string | — |
collectionStatus | string | — |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/co/secop/contracts -m POST -b '{"supplier": "NUTRESA", "maxResults": 3}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Colombia SECOP Contracts Scraper + Company Registry. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt